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INTRODUCTION 



BACKGROUND 

The Burroughs Micro Implementation Language (MIL) is a symbolic coding technique that makes available 
all the capabilities of the B 1700 Processor. The MIL compiler's machine language output is ready for 
execution directly upon the hardware. The user, however, must be prepared to programmatically control 
the total environment including bootstrap loading, interrupt servicing, and potential machine malfunction- 
ing (e.g., parity error detection). 

To use MIL properly and efficiently, the programmer must have an extensive knowledge of the available 
registers and their capabilities. This manual describes the registers, the syntax and the semantics of the 
MIL language and may be used to write programs without prior knowledge of the system. 

/ 
RELATED DOCUMENTS 

A description of the Input/Output subsystem and the I/O descriptors as well as more detailed information 
about the registers can be found in the B 1700 Systems Reference Manual (form 1057155). 
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1 . MICROPROGRAMMING CONCEPTS 



GENERAL 

Microprogramming is a method for programming a computer hardware architecture. The microprogrammer 
is concerned with machine registers which were formerly the domain of the hardware systems designer. 
Strings of micro-instructions manipulate those internal registers to present an outward appearance of 
system hardware which is more functional for problem-oriented programming. In most machines now in 
the market place, read-only memories (ROM's) contain microprograms which convert the unique internal 
environment of several different processors into a standard assembly language. Once created, the micro- 
programs are unalterable and may contain compromises in efficiency because of a limited hardware instruc- 
tion set. 

The Burroughs B 1 700 system makes use of the latest technology to implement a writable control memory 
and has several microprograms, each optimized for the functions it will perform. The virtual system archi- 
tectures chosen have been those of the standard (such as COBOL and FORTRAN), problem-oriented, 
compiler languages. Other microprogrammers may choose architectures and create languages optimized 
for other purposes. 

MICRO-INSTRUCTIONS 

A micro-instruction is the smallest programmable operation within the system. Each micro-instruction is 
fetched from memory and decoded in the (micro) register to be directly executed by the hardware. 

DEFINED FIELD CONCEPTS 

A defined field concept allows bit-level data addressing with lengths from 1 to 65,535 bits. There are no 
visible boundaries or "best" container size for any information contained in main memory. Virtual 
machine instruction strings (the B 1 700 analog of machine object code) and their data may thus be densely 
packed into meaningful fields, saving considerable memory space. The programming problem of packing 
and unpacking data fields across hardware container boundaries is completely resolved, saving much pro- 
gramming effort and processor time. The microprogram fetches groups of bits in meaningful field sizes 
from anywhere in main memory as needed. 

Special hardware, called a Field Isolation Unit, has been implemented to achieve bit addressability and 
variable length fields and to automatically increment addresses. This allows maximum flexibility in defin- 
ing data fields and resolves the problem of packing and unpacking data fields across hardware container 
boundaries. 
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INTERPRETATION OF THE VIRTUAL LANGUAGE 

The traditional approach to supporting a higher-level language is to translate the source statements as 
written by the programmer into another language either directly recognized by the hardware, (e.g., machine 
object code) or easily translatable into the machine object code (e.g., an assembly language). An alternate 
technique is the interpretive execution for each source statement with a logically equivalent routine in some 
lower-level language. A microprogrammed system offers the opportunity to combine the best of both 
methods. The source statements in the higher-level language are translated into a virtual system code by 
a compilation process. This system code, also called S-code or S-language, very closely resembles the 
original source language. Micro-instruction routines then interpretively execute each virtual language state- 
ment. The results are: 

a. Faster compilation, 

b. System architecture, as expressed in the set of microroutines, which is optimized to the source 
language, 

c. Reduction in the processor time required to perform the logical equivalent of each source state- 
ment, 

d. Reduction in the memory space required to encode each source language operation. 

A set of microprogrammed routines is called an interpreter and effectively creates a virtual system archi- 
tecture for the source language being executed. That is, when the COBOL interpreter is executing, the 
system is effectively a COBOL machine. When the FORTRAN interpreter is executing, the system is a 
FORTRAN machine, and so on for any other S-language defined. 
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2. SYNTAX DIAGRAMS 



The principal means of describing MIL syntax is through the syntax diagram, commonly known as "rail- 
road" notation. The basic conventions are discussed below. 

FORWARD ARROWS 

Any path traced along the directional flow of the arrows will produce a syntactically valid command. The 
following example illustrates the technique: 



XDOWN-t** 
UP -»J 



BY THE 



JT~1 

-I T » » OLD - 1 



t J" 

RIVERSIDE — 



'STREAM 



,r u 



WHERE I 



FIRST - 
LAST ■ 



SAW 



I ~* £>MW T 

' ■»• FOUND -•J 



YOU 



17 



(NOT ME BUT YOU) 
*- TADPOLES 



7" 



Valid syntax generated from this diagram could be : 

DOWN BY THE OLD MILL STREAM 

UP BY THE OLD, OLD STREAM 

DOWN BY THE RIVERSIDE WHERE I FOUND TADPOLES 

DOWN BY THE OLD STREAM WHERE I FIRST SAW YOU (NOT ME BUT YOU) 

UP BY THE RIVERSIDE WHERE I LAST FOUND YOU 

The bridge over OLD, unless otherwise specified, can be crossed any number of times. 

END OF STATEMENT \ 

The completion of a statement is indicated by the following convention: 
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CONTINUATION 

The following convention indicates that any number from through 9 is syntactically valid: 



KEYWORDS 

Upper-case letters indicate keywords which must literally appear in MIL statements. 

VARIABLES 

Lower-case letters, words, and phrases within angle brackets indicate syntactic variables which require 
information to be supplied by the programmer. The following example illustrates the technique: 



THE - 
SOME 



{animals) WERE 



NEAR 



CLOSE TO 



THE ibody-of-water) *► ? — »| 



Valid syntax generated from this diagram might be: 

THE TADPOLES WERE IN THE STREAM? 
COWS WERE CLOSE TO THE POND? 
SOME BIRDS WERE NEAR THE OCEAN? 
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. 3. BASIC COMPONENTS OF MIL 



GENERAL 

To understand MIL grammar the user should be familiar with the following basic elements of the MIL 
language. 

{point): 



{underscore): 



(digit): 



(letter): 
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< special. characters): 



& 

@ 



> 
< 



3 



ampersand 



blank (one non-visible character) 



IDENTIFIERS 

{identifier): 



{letter) ■ 



(digit) 
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Examples 

TEST.NAME. 1 
LABELS 

{label): 



1. 

2. 
3. 



RESTRICTIONS 

An {identifier) must begin with a < letter). 

An { identifier) may not contain blanks. 

Reserved words may not be used as < identifiers). 
(See Appendix C: Reserved Words and Symbols.) 

An < identifier) is limited to a maximum of 63 
characters: only the first 25 characters are used 
in uniqueness detection. 



T.123.Q ABC LOOP.. 12 



i r 



{letter) 
{digit) 



J 



r 



^=J 



< unique. label): 



{label) 



{ point, label, declaration) : 



■.{label) »J 



< point, label, reference) : 



"*- + '■ T *• 

-#► - hi 



<fcZ>efl- 



H 
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(label.reference): 



{ unique • label) • 



{point • label • reference) 



J 



( label.declaration): 



■ (unique.label) ■ 



< point. label.declaration) 



J 



< Labels)* may be declared by: (1 ) starting the < label) anywhere in columns 1 through 5 of a source image, 
or (2) starting the < label) immediately after the reserved words TABLE, SEGMENT, or CODE. SEGMENT. 
(See also Segmentation: Label addresses.) 

RESTRICTIONS 

1 . A < label) must begin with a < letter) or a < digit) 

2. A < label) may not contain blanks. 

3. A < label) is limited to a maximum of 63 characters: 
only the first 25 characters are used in uniqueness 
detection. 

4. < Unique Label)* may be declared only once. 

5. < Point Label)* may or may not be unique. 
Examples 

.A.POINT.LABEL REGULAR.LABEL LOOP BEGINNING.OF.TEST.l 

CARD TERMINATORS 

< card, terminator) : 



% 



H 



3^4 



NUMBERS 

{number): 



RESTRICTION 

A percent sign (%) is treated as any other string charac- 
ter if it is contained within a < character-string). How- 
ever, in all other cases, a % will cause the scanning of 
the current source image to terminate. 



{decimal, number) ■ 
*" {bit 'group) 



J 



( decimal number): 



• { digit) 



BIT STRINGS 

{binary-string): 



I ^ t fj 



{quartal string): 
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(octal-string): 



(hex- string): 



r 




9 
A 

'f 



< bit-group): 



(hex- string) — 
(4) (hex • string)- 



-*> (3) (octal • string) — 
-♦-(2) (quartal • string)- 
-*- (1) (binary string)— 



A 



(hit- string): 



(bit • group) ■ 



RESTRICTION 

If no bit mode is specified (i.e., the indicator digit in 
parentheses is omitted), then "hex" is assumed. 
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{string): 



{ character • s*n'«g > - 



{bit- string)- 



CHARACTER STRINGS 

< character.string): 



{string • character • Zfs/> - 



< string, character, list) : 



{string- character) - 



{ string, character) : 



{digit)- 



{letter)- 



{special • character) 



Examples 



"** THIS IS AN EXAMPLE OF A CHARACTER STRING" 
ROW THE BOAT GENTLY . . ." 

RESTRICTION 

The quotation mark (") cannot be specified as a 

{ string character). As an alternative, the programmer 

can specify a < hex string) instead of a < character.string). 
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LITERALS 

{UteraD: 



{number) ■ 
{string) — 



► {declare • special) — 
•{declared • identifier) 



{declare- special): 



DATA.LENGTH {declared • identifier) 

LENGTH. BETWEEN. ENTRIES {{array identifier)) 



{ declared- iden tifler) : 



{simple ■ identifier) 
{array • identifier) - 



J 



< array- iden tifler) : 



{simple ■ identifier) 



-*■ (array • index) 



{array-index): 



{number) ■ 



DATA LENGTH {{declared identifier)) will supply the specified or computed length in bits of the indicated 
< declared- identifier). For an < array -identifier), the length will be the length of one of the items in the 
array, not the length of the entire array. 
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LENGTH-BETWEEN-ENTRIES {{array identifier)) will supply the bit difference between the beginning of 
one item in the specified array and the next item in the array. Note that in the case of structured arrays 
(See Structured Declarations) this will not always be the same as DATA-LENGTH {array- identifier). 

Examples: 

1587 

"STRING" 

DATA-LENGTH (AN-ITEM) 
ARRAY-ELEMENT (7) 

ARITHMETIC EXPRESSIONS 

{arithmetic- expression): 



£ 



• {unary • operator) ■ 



{arithmetic' expression) {adding- operator) 



{term) 



{ term): 



■*• {literal) 



'{term) {multiplying • optrator) {literal) *■ 

-{arithmetic • expression) 1» 



{unary -operator): 



adding- operator) 



{ adding- operator) : 
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< multiplying- operator): 



J 



{Arithmetic expressions yield numerical values by combining < literaDs in accordance with specified 
operations. The operators +,-,*, and / have the conventional mathematical meanings of addition, sub- 
traction, multiplication, and division, respectively. 

The sequence in which operations are performed is determined by the precedence of the operators involved. 
The order of precedence is: 

First: * / 
Second: + - 

When operators have the same order of precedence, the sequence of operation is determined by the order of 
their appearance, from left to right. Parentheses can be used in normal mathematical fashion to override 
the usual order of precedence. 

Parenthesized expressions are treated as (termh, i.e., they are evaluated by themselves and the resulting 
value is subsequently combined with the other elements of the < arithmetic- expression). Thus the normal 
precedence of operators may be overridden by careful placement of parentheses. 
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4. STRUCTURE OF A MIL PROGRAM 



There are two parts or sections to a MIL program: the declarations and the body. The declarations should 
contain: 

a. A comment description of the function of the MIL program. 

b. Any global data structures (DECLARES). Note that "global" refers to use throughout the 
program; local refers to use restricted to a part of the program. 

c. Any global DEFINEs. 

d. Any MACRO definitions. 

The body follows the declarations and will contain all code-producing statements. The statements should 
be logically grouped in labeled BEGIN . . . END blocks. Each BEGIN . . . END block may contain its own 
local data structures, LOCAL.DEFINES or labels. The last statement of the body should be FINI. 

The following is a basic outline of a MIL program using the above general rules. For specific details on 
assembly coding forms and program examples refer to: Programming Techniques. 



Declarations 



% descriptive comment 
DECLARES 
DEFINEs 
MACROs 



LABEL.A 



Body 



BEGIN A 

(code for A) 
END A 
BEGIN B 

(code for B) 
ENDB 
FINI 
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5. SEGMENTATION 



INTRODUCTION 

Segmentation in MIL is a multi-faceted and somewhat complicated subject. Because MIL is the language 
of the B 1700's, and because it is used for many different purposes (Diagnostics, Emulators, Interpreters, 
I/O Drivers, MCP Kernels, etc.), it must attempt to satisfy the needs of a wide range of users. Segmentation 
plays a particularly important role on the B 1 700 because of the READ/WRITE access capability of the 
hierarchical memory structure (M-Memory, S-Memory, Disk). 

LABEL ADDRESSES 

To begin the discussion on segmentation, we must first identify the label types pertaining to address assign- 
ment. They are: < regular- label) and (physical.label). (These should not be confused with the two types 
of label representation -.{unique. lab el) and {point, label) . See Basic Components Of MIL: Labels.) The types 
are based on how the labels are declared which in turn determines how the address of the label is to be 
assigned. 

A < label) which is declared by starting it in column 1-5 of a source image is always a < regular, label). 

A < label) which is declared by starting it immediately after the reserved words TABLE, SEGMENT, or 
CODE.SEGMENT is always a (physical label). 

A < regular. label) is always given the current < segment. code.address) when the < label) is declared. 

A (physical. label) is always given the current {physical. code. address) when the < label) is declared. 

The ( segment. code. address) is updated by 16 as each micro-instruction is generated and can be changed to 
a new value by the appearance of a SEGMENT or CODE.SEGMENT statement. 

The ( physical, code, address) is also updated by 16 as each micro-instruction is generated and can be changed 
to a new value by the appearance of an ADJUST LOCATION statement. (See MIL Statements: ADJUST). 

Both the < physical.code.address) and the < segment. code. address) are initialized to (zero) when a compila- 
tion begins. 
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SEGMENT STATEMENT 
Syntax 



NEWSEGMENT- 
(label) 



J 



AT 



- ADDRESS (label)- 
-(literal) 



T 



NOTE 

The < literal) must be MOD 1 6, meaning the last four 
bits must be @ (1)0000®. 



Semantics 



Through the use of the SEGMENT statement, the user has the means to divide his/her MIL program into 
several parts such as a single (primary. code. block) and one or more (segment.block) (s). The (primary, 
code. block) should provide one or more areas suitable for containing the individual (segment.block) (s). 
These areas are designated by declaring one or more ( regular. label)(s) somewhere within the (primary. code, 
block). Quite often there will be only one designated area for ( segment. block)(s), and it will begin at the 
end of the < primary, code, block). 

The purpose of the SEGMENT statement is to inform the compiler exactly where the (segment.block) will 
be (relative to the < primary, code, block)) when its code is executed. In this way the compiler can generate 
the correct branch/ call displacements whenever a statement in the (primary. code. block) branches to or 
calls a routine in one of the ( segment. block)(s). In the same way, a statement in one of the < segment. 
block){s) may branch to or call a routine in either the (primary. code. block) > or in any of the (segment. 
block)(s). (See MIL Statements: EMIT.RETURN.TO.EXTERNAL, CALL.EXTERNAL, BRANCH. 
EXTERNAL.) 

All code is assumed to be in the < primary. code.block) until the first SEGMENT statement is encountered. 
From this point one, all code is assumed to be in that segment until the next SEGMENT statement is 
encountered, and so on. 

The SEGMENT statement may also be used to specify logical breaks within a continuous stream of code. 
In this case, only the name of the segment needs to be specified since the code addresses are to continue 
linearly. The entire program and all of the ( segment, bloc k)(s) are given entries in the segment dictionaries 
as part of the parameter blocks associated with a MIL code file. From these dictionary entries and from 
the segment name-to-number correspondence table the addresses and lengths of each segment are available 
and can be used to do sophisticated static binding prior to execution of the code. (See MIL Statements: 
MAKE.SEGMENT, TABLE.ENTRY). 
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CODE. SEGMENT STATEMENT 
Syntax 



CODE.SEGMENT - 



-*►< label) »-| 



Semantics 



Another form of segmentation in MIL is used when a microprogram is running with the MCP, or under MCP 
control. All of the interpreters as well as GISMO are examples of this situation. With this mechanism, a 
microprogrammer is able to specify which portions of the program are to reside on disk until they are 
actually needed for execution. This provides the programmer with the same facility normally only found 
in higher level languages. 

In order to use this facility, the programmer must follow certain rules and remember some restrictions. 
First, some definitions: 

< main. code, block): all code generated until the first CODE.SEGMENT statement is 

encountered ; this may encompass the < primary, code, block) and 
one or more ( segment, bloc k)(s). 

< external. code. block): all code generated between a given CODE.SEGMENT statement 

and the next CODE.SEGMENT statement, or the end of the 
program, whichever comes first. 

< main.code. base): the M-Memory bit address of the first micro-instruction in the 

< main. code, block). If no part of the < main. code, block) resides 
in M-Memory, then the < main.code. base) should be 0. 

If the processor is an S-Memory processor, then the < main. code, base) 
should be the memory address of the first micro-instruction in the 
program. (See MIL Statements: MAIN.CODE.BASE.) 

< mbr. topm): a 24-bit bucket containing the MBR value for the < main. code. block) . 

In addition, since the MBR value is always a MOD 16 number, the low 
order 4 bits of < mbr. topm) should be the TOPM value of the 

< main. code, block). 

The microprogrammer must provide the following items in a program: 

a. A define for MAIN.CODE.BASE to indicate the Scratchpad word containing < main.code.base). 
Example: 

DEFINE MAIN.CODE.BASE = S14B# 

b. A define for MBR.TOPM to indicate the Scratchpad word containing < mbr. topm). 

Example: 

DEFINE MBR.TOPM = S15A 
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NOTE 

The above defines must be included in the < main. code, 
block) and must not be defined within some LOCAL. 
DEFINE scope. In addition, the two Scratchpad 
locations must be initialized by the interpreter when 
it is given control from GISMO. 

A routine labeled GO.TO.EXTERNAL.SEGMENT to interrogate the interpreter dictionary and 
generate a communicate (if necessary) to guarantee that the requested < external, code. segment) 
is present in S-Memory. In addition, it must perform the initial transfer to the < external, code. 

segment). 



Example: 



GO.TO.EXTERNAL.SEGMENT 

% T CONTAINS SEGMENT NUMBER 
% L CONTAINS BIT DISPLACEMENT 



SHIFT T LEFT BY 6 BITS TO X % 

SHIFT T LEFT BY 4 BITS TO Y % 

MOVE SUM TO FA % 

ADD ADDR.INTERP.SEG.DICT TO FA 
READ 2 BITS TO X 
IF LSUX THEN 

BEGIN PRESENT 

COUNT FA UP BY 32 
READ 24 BITS TO X % 

IF SUBSET THEN INCLUDE % 
BEGIN 

MOVE L TO Y 
MOVE SUM TO A 
END ELSE 
BEGIN 



WITHIN SEGMENT 
T* 64 

T* 16 
T* 80 



% THE SEGMENT IS PRESENT 



SEGMENT BASE ADDRESS 
FOR S-MEMORY PROCESSORS 



MOVE TO TAS 


% 




% 


MOVE L TO T 


% 


MOVE X TO L 


% 


TRANSFER.CONTROL 




END 




END PRESENT 




MOVE T TO L 




MOVE 58 TO T 


% 




% 


SHIFT T LEFT BY 16 BITS 




SET L(0) 


% 


GO TO GIVE.UP.CONTROL. 


% 




% 



NECESSARY FOR 
M-MEMORY SYSTEM 
NEW A AND TOPM VALUE 
NEW MBR VALUE 



COMMUNICATE NO. FOR 
NON PRESENT SEGMENT 

ONE LEVEL SEG DICT. 
SAVE STATE AND XFER TO 
MCP VIA GISMO 
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NOTES 

a. The initial "T" and "L" values are supplied by the 
compiler prior to entering the above routine. 

b. Other registers may be destroyed depending on 
how the routine is written. 

c. The routine must push a (zero) onto the A stack 
for the M-Memory Processor. This is necessary so 
that an exit within an < external.code.block) can 
be trapped into a routine that will transfer control 
back to the < main. code, block). This also implies 
that parameters may not be passed via the A stack 
when initially transferring to an < external, code, 
block). 

The compiler will provide all other routines necessary to effect the transfer to and from < external.code. 
block)(s). 

The only kind of transfers allowed are calls and branches from the ( main.code.block) to an < external.code. 
block) and from an < external.code.block) to the < main.code.block). Transfers between < external.code. 
block){s) are not allowed. In addition, such calls and branches must be syntactically separated from calls 
and branches with the same < code, block). Instead of CALL, the command CALL EXTERNAL must be 
used. Instead of GO TO, the command BRANCH.EXTERNAL must be used. (See MIL statements: EMIT. 
RETURN.TO.EXTERNAL, CALL.EXTERNAL and BRANCH.EXTERNAL.) 

Compiler - Generated Code 

Following is the code the compiler generates when CODE. SEGMENTS are used. (All < labefis used in the 
examples are shown for clarity only: the compiler has its own internal representation for the labels.) 

MAIN CODE BLOCK 

a. For each different < label) occurring after a CALL.EXTERNAL or BRANCH.EXTERNAL 
statement in the < main.code.block), the compiler will divert the call or branch to the following 
code which is generated at the end of, and part of, the < main.code.block): 

MOVE ADDRESS (label) TO L 
MOVE ( label.segment. number) TOT 
GO TO GO.TO.EXTERNAL.SEGMENT 

b. If the program executes on an M-Memory Processor (B 1726), the following code will be emitted 
in the main.code.block: 

EXIT.TO.EXTERNAL 
MOVE TAS TO L 
MOVE TAS TO T 
MOVELFTOTF 
MOVE TO LF 
TRANSFER.CONTROL 
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EXTERNAL CODE BLOCK 

a. If the program executes on an M-Memory Processor (B 1726), the following code will be emitted 
at the beginning of every < external, code, block) : 

MOVE TAS TO T 
LEAVE.EXTERNAL. SEGMENT 
MOVE MBR TOPM TO L 
MOVE LF TO T 
SET LF TO 
TRANSFER.CONTROL 

b. For each different < label) occurring after a CALL.EXTERNAL or BRANCH.EXTERNAL 
statement in the < external, code, block), the compiler will divert the call or branch to the follow- 
ing code which is generated at the end of, and part of, the < external.code. block): 

1. If the program executes on an S-Memory PRocessor (B 1712 - B 1714) the following 
code is generated: 

MOVE ADDRESS « label)) TO X 
GO TO SUBSET. BRANCH.TO.MAIN 

2. If the program executes on an M-Memory Processor (B 1726) the following code is 
generated for each different < label) in a BRANCH.EXTERNAL statement: 

MOVE ADDRESS ((label)) TO X 
GO TO BRANCH.TO.MAIN 

3. If the program executes on an M-Memory Processor (B 1726) the following 
code is generated for each different < label) in a CALL.EXTERNAL statement: 

MOVE ADDRESS ((label)) TO X 
GO TO CALL.TO.MAIN 

c. At the end of every < external, code, block) the following code is emitted. 

1 . For S-Memory Processor (B 1 7 1 2 - B 1 7 14) : 

SUBSET.BRANCH.TO.MAIN 

MOVE MAIN.CODE.BASE TO Y 
MOVE SUM TO A 

2. For M-Memory Processors (B 1726): 

BRANCH.TO.MAIN 

MOVE TAS TO NULL 

MOVE MAIN.CODE.BASE TO Y 

MOVE SUM TO T 

GO TO LEAVE.EXTERNAL.SEGMENT 
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CALL.TO.MAIN 

MOVE MAIN.CODE.BASE TO Y 

MOVE SUM TO T 

MOVE MBR TO L 

MOVE TOPM TO LF 

MOVE L TO TAS 

MOVE ADDRESS (EXIT.TO.EXTERNAL) TO X 

MOVE SUM TO TAS 

GO TO LEAVE.EXTERNAL.SEGMENT 

NOTES 

a. When branching from the < main. code, block) to an 

< external, code, block) the T and L registers are 
used, plus whatever registers the GO.TO.EXTER- 
NAL. SEGMENT routine uses. 

b. When calling or branching to a routine in the 

< main.code.block), the X and Y registers are used: 
This means that they cannot also be used for 
passing parameters. In addition CP should be 
equal to 24, otherwise the transfer may not take 
place correctly. 

Also, on an M-Memory Processor, the T and L 
registers, as well as the A stack are used. Thus, a 
good rule of thumb is to avoid using X, Y, T, L, 
and TAS when passing parameters to/from the 

< main.code.block) and < external.code.block)(s). 

c. The code for S-Memory Processors is different 
than the code for M-Memory Processors. Thus, 
CODE.SEGMENTS cannot be used if the program 
is to execute interchangeably on either the B 1710 
or B 1720 Series processors. (See Appendix A: 

$ NO EXTERNAL). 
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6. DECLARATIONS 



DATA TYPES 

Three main types of data fields may be declared in MIL: 

1. BIT 

2. CHARACTER 

3. FIXED 

A bit field consists of a number of bits specified by a number in parentheses following the reserved word 
BIT. 

A character field consists of a number of 8-bit characters specified by a number in parenthesis following 
the reserved word CHARACTER. 

A FIXED data field is the same as a BIT (24) field but is allowed in order to keep declare syntax con- 
sistent with SDL . 

DECLARE STATEMENT 
Syntax 



I 



DECLARE * ^. (declare ' element) 



Semantics 

The DECLARE statement specifies the addresses and characteristics of contents of memory storage areas. 

The maximum number of data elements (including fillers, dummys, and implicit fillers) allowed in one 
structure is 50. Any attempt to declare more will cause a table overflow error to be detected at compile 
time. 

An < array) may have a maximum of 65535 elements, each being a maximum of 65535 bits (8191 charac- 
ters). 

The two types of < declare, elements) are discussed separately below. 
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Non-Structured Declarations 

< declare. element): 



»► (identifier) — 
-(array • id) ({#)) 



(identifier)- 



-(array id) «#)] 



J 



(identifier) 

(array • id) «#» 



U 



REMAPS- 



BASE.ZERO 



ABSOLUTE (literal)- 



—»~ADDRESS((unique* label )) — ■» 

*- (identifier) in 

1 — *- (array • id) * 



L*. REVERSE -J 



BIT«#» 



-*► CHARACTERS)- 
-FIXED 



•BIT«#»- 



CH A RACTER «#))-*■ 
FIXED 



REVERSE 



T 



Note: (<#)) = ((number)) 



Data may be declared as simple, having one occurrence, or as subscripted, having as many occurrences as 
specified by the < array bound). In the latter case, array subscripts are considered to range from 
zero to < array bound)- 1 . 

BIT, CHARACTER or FIXED specifies the type of data in the field and the field size. 

REVERSE specifies that an item or a structure is to be accessed in a reverse manner or in a reverse direction 
from some base. The easiest way to remember what is happening is to realize that the compiler will simply 
compute the address of a declared < identifier) normally, and then, if reverse is specified, subtract the 
< identifier)' s length from the address to get the starting address of the (identifier). 

As the syntax indicates, different data fields having the same format may be declared collectively inside 
parenthesis ( ). 

The following example illustrates the various options available in this type of < declaration statement). 
Example 



DECLARE 
PRIDE 

COVETOUSNESS 
GLUTTONY 

(LUST, ENVY, ANGER (5)) 
SLOTH (20) 
WRATH (5) 



FIXED 

CHARACTER (10), 
BIT (40), 
BIT (10), 
FIXED, 
CHARACTER (6); 
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where 

PRIDE is a 24-bit numeric field; 

COVETOUSNESS is a 10-byte character field; 

GLUTTONY is a 40-bit field; 

LUST and ENVY are each 10-bit fields, as is each of the five elements 

comprising ANGER; 
SLOTH occurs twenty times, each element being a 24-bit numeric field; 
WRATH is a six-byte character field occurring five times. 

Data fields may be re-formatted by the use of the REMAPS option. Remapping is subject to the same 
general rules discussed above. The following example best illustrates its use: 

B FIXED, C BIT (50), 

BB REMAPS B CHARACTER (3), 

CC (2) REMAPS C FIXED; 

Note that CC specifies 48-bits (or 2 elements, 24-bits each). The last two bits will be considered as an 
implied filler by the compiler. A field may not be remapped larger than its original size. 

There is no limit on the number of times a field may be remapped. A field which has remapped another 
may itself be remapped. The remap option specifies that the < identifier) on the left side of the reserved 
word REMAPS will have the same starting address as the < identifier) on the right side. 

A data field may be remapped to BASE.ZERO which will give the field a relative address of zero. For 
example: 

DECLARE Q REMAPS BASE.ZERO BIT (7); 

This device is used as a free-standing declaration since it does not remap a previously declared data item. 
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Structured Declarations 

< declare, elemen t) : 



(level) 



(identifier)- 



-(array ■ id)((#)) 

..1 



u 



(identifier) ■ 
(array. id)((#)) 



J 



*» ) -*■ 



■*• FILLER 



(identifier) 



T* 



iarray . id)((#>) 
- DUMMY 



n — t 



LZ 



REMAPS 



BASE.ZERO 



ABSOLUTE </fcra/> 



ADDRESS (unique . label/ 

(identifier) 

■ (array . id > 



REVERSE 



tl 



BIT «#»- 



Hlfc 



CHARACTER «#))• 
FIXED 



BIT«#»- 



CHARACTER «#»-*■ 
FIXED 



REVERSE 



:j 



Note: (<#» = ((number)) 



MIL allows the structuring of data where a field may be subdivided into a number of sub-fields, each of 
which has its own < identifier). The whole structure is organized in a hierarchical form, where the most 
general declaration is a < level) 01 (or 1). No declaration may be on a < level) greater than 99. A sub- 
divided field is called a Group Item, and a field not subdivided is known as an Elementary Item. 

The type and length of data need not be specified on the group level. All Elementary Items must indicate 
type and length; the compiler will assume type bit and add the lengths of the components to determine 
the length of the Group Item. Note that the length of the Group Item is the sum of the lengths of its 
Elementary Items. 

In the following example, both A.A and C.C are considered Group Items; A.A has a total length of 90 bits, 
and C.C is 50 bits in length. 

Example 

DECLARE 

1 A.A, 

2 C.C, 

3 D BIT (20), 

3 E BIT (30), 

2 H CHARACTER (5); 
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Fillers may be used to designate certain Elementary Items which the program does not reference. If the 
filler is the last item in a structure, it may be omitted ; the compiler will consider the Group Item to have 
an implied filler. A filler may never be used as a Group Item. 

If the 1 level group item is an < array), it is mapped as a contiguous area in memory. However, sub- 
divisions of this ( array) are not contiguous as shown in the example structure below: 

Example 



1 Q(5) 


BIT(48) 


2 R 


FIXED, 


2 W 


FIXED; 



or 



DECLARE 

1 Q(5) 

2 (R, W) FIXED; 







— ^- (each item of Q) 48 bits 


















QO 


Q1 


Q2 


Q3 


Q4 


RO 


WO 


R1 


W1 


W1 


R2 


R3 


W3 


R4 


W4 






^- (each it 


em of R a 


idW) 24 


bits 

















If a Group Item is an < array), an < array specification) may not appear in any subordinate item; that is, only 
one-dimensional (array)s are allowed. An (array specification) is implied for all subordinate items. 

If a Group Item is declared with the REVERSE option, then REVERSE is also implied for all subordinate 
items in that group. Specification of the REVERSE option for subordinate items would be redundant. 

Structured data may be remapped in the same manner as non-structured data. In addition, structured data 
may be remapped with a dummy group identifier. The purpose of this construct is to allow the user to 
remap data items without having to declare another Group Item which describes the same area in memory. 
Thus in the following example : 

Example 

DECLARE 

1 YAK BIT(IOO), 

2 AARDVARK BIT(20), 

2 SEA.OTTER BIT(80); 



YAK might be remapped as: 

DECLARE 

1 AA REMAPS 
2 CC 
2 DD 



DECLARE 

YAK BIT(IOO), 1 DUMMY REMAPS YAK BIT(IOO), 

BIT(30), or 2 CC BIT(30), 

BIT(70); 2 DD BIT(70); 



Both YAK and AA refer to the same area in memory: hence AA is redundant. 
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If a remapped item contains the REVERSE option, then REVERSE is also implied for the remapping item. 

The user should note the distinction between DUMMY and FILLER. DUMMY is used in conjunction with 
REMAPS to eliminate the necessity of declaring a redundant Group Item. FILLER is used if one desires 
to skip over a part of the structure. 

The following restrictions apply to the use of DUMMY REMAPS; 

1 . DUMMY may only be used with < remap declarations). 

2. All restrictions applying to REMAPS apply to DUMMY REMAPS. 

3. DUMMY must not remap another DUMMY. 

4. DUMMY Group Items must have at least one non-filler component. 
DECLARE EXAMPLES 

Introduction 

Let us illustrate by example exactly how declarations might be used in a MIL program, and note the 
associated relevant points. 

The DECLARE statement in MIL is one which allows the user to logically assign names to physical or 
relative memory address in a structured manner. This facility allows one to construct data structures 
in a format that is simple to understand and easy to change when the occasion arises. 

Non-Remap Items 

The MIL compiler maintains a variable which is initialized to 0. When an item is declared, it is assigned 
the current value of this variable and the variable is incremented by the bit length of the declared item. 

Example 



DISPATCH. REGISTER 


BIT(24), 


GLOP1 


BIT(48), 


ADDR.GISMO 


BIT(24), 


LOCN.MAKE.MCP.BE.HERE 


BIT(36), 


GLOP2 


BIT(29), 


ADDR.MCP. LIMIT 


FIXED; 



Note that the DECLARE statement is completely free form, must begin with the world "DECLARE", must 
end in a ";", and that each element must be separated from its predecessor with a ",". 

Each element thus declared is used exactly as a (literal > and most often represents a memory address. 
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Example 

MOVE ADDR.GISMO TO FA 
READ 24 BITS TO X 

This would assign the literal 72 (= 24+48 = ADDR.GISMO) to register FA and would cause the contents 
of memory at address 72 to be read into register X. 

Should the compiler encounter another DECLARE, it will merely start assigning addresses where it left 
off previously. 

Example 

DECLARE 

GLOP3 BIT(IO) 

CHAR.SAVE.AREA CHARACTER(8); 

GLOP3 above would be assigned the value of the aforementioned address-counting variable, in this instance 
185. 

DECLARE elements may also be structured such that some names overlap pieces of memory described 
by other names. 

Example 



1 




TRACE.BITS 


BIT(27) 


5 




FILLER 


BIT(15) 


5 




TB.FLAGS 


BIT(l), 


5 




TB.TYPE 


BIT(4), 




8 ■ 


FILLER 


BIT(l), 




8 


TB.STORES.ONLY 


BIT(l), 




8 


TB.BRANCHES 


BIT(l), 




8 


TB.THE.REST 


BIT(l), 


5 




TB.GET.SPACE.TYPE, 






99 


(TB.STORES.ONLY, 
TB.BRANCHES, 








TB. REMAINDER) 


BIT(l); 



This example illustrates the following points: 

1 . The address picks up where the previous DECLARE leaves off. This is not true, however, where 
the previous item or structure is a "remap item". The compiler's internal variable used for 
default address assignment is maintained and incremented only for non-remap items or structures. 

2. DECLARES may be structured such that some fields are denoted as being contained within 
other fields. 

3. "FILLER" can be used in structures as often as necessary to increment the address-counting 
variable past an area of memory which the programmer does not intend to reference by a 
symbolic name. 
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4. Items with the same type and length can be put into a list surrounded by parentheses, with the 
type and length specified only once at the end. 

5. The length of an item need not be specified if it has sub-items whose lengths can be determined. 

NOTE 

Structures must begin with an "01" level identifier. 
Substructures may then have any level from 02 to 99 
inclusive, with the substructure always having higher 
level numbers than the superstructure. 

Remap Items 

GENERAL 

It is possible to temporarily suspend the mechanism which causes addresses to be assigned based on where 
the last DECLARE left of by using remaps structures. 

For example, if we wish to declare a "template", where the declared addresses are added to some base prior 
to actual use, we would do the following: 



DECLARE 






1 


SYSTEM.DESCRIPTOR REMAPS BASE.ZERO, 


2 


SY.MEDIA 


BIT(2), 


2 


SY.LOCK 


BIT(l), 


2 


(SY.IN.PROCESS, 
SY.INITIAL, 






SY.FILE) 


BIT(l), 


2 


FILLER 


BIT(IO), 


2 


SY.TYPE 


BIT(4), 


2 


SY.ADDRESS 


BIT(36), 


3 


FILLER 


BIT(12), % PORT AND CHANNEL 


3 


SY.CORE 


BIT(24), 


2 


SY. LENGTH 


BIT(24); 



One might use the above structure as follows: 

DEFINE SYS.DESC.BASE = S14A# 

% 

MOVE SY.TYPE TO FA 

ADD SYS.DESC.BASE TO FA 

READ DATA. LENGTH (SY.TYPE) BITS TO X 

Note the use of a new reserved word, "DATA. LENGTH". This construct allows one to use the length of a 
declared item without having to define it elsewhere. 
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The remap structures that are permitted are: 

1. REMAPS BASE.ZERO 

2 . REMAPS AB SOLUTE < literal ) 

3. REMAPS ADDRESS {{.unique. label)') 

4. REMAPS {identifier) 

5. REMAPS {array. identifier) 

If one knew the absolute address of some data structure in memory, the following could be done: 

DECLARE 

1 SAVE.AREA REMAPS ABSOLUTE 1024, 

2 SA. FIRST. ITEM FIXED, 

2 SA.SECOND.ITEM CHARACTER(200), 

2 SA.THIRD.ITEM BIT(256); 

The following technique could be used when a < label) denoting the start of a table of constants was 
present in a program: 

DECLARE 

1 TRACE.TABLE( 1 0) REMAPS ADDRESS (TRACE.MNEMONICS), 

2 ADDR.TRACE.NAME CHARACTER (4);% 

% 
TRACE.MNEMONICS 
TABLE 
BEGIN 

"LA 

"ALA 

"STN 

"STD 

"LIT 

"ILA 

"STO 

"CASE" 

"IFTH " 

"IFEL " 
END 
% 

MOVE ADDR.TRACE.NAME (2) TO FA 
READ 24 BITS TO X INC FA 
READ 8 BITS TO Y 

Note the use of < array) in the above example. If the programmer does not know the index to use at 
compile time, the following could be done: 
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DEFINE TRACE.INDEX = SOB 

% 

MOVE TRACE.INDEX TO X 

MOVE LENGTH.BETWEEN.ENTRIES (TRACE.TABLE) TO Y 

CALL MULTIPLY.X.Y 

% AND SO FORTH 

% 

MULTIPLY. XY 

% MULTIPLICATION CODE 

EXIT 

The above examples have shown, among other things, two of the "specials" that are included in MIL syntax 
to augment usage of DECLAREd items. They are: 

DATA. LENGTH « declared.identifier)) 
LENGTH.BETWEEN.ENTRIES « array. identifier)) 

Note that when < array) names are used with the specials, the subscript is not included; it is syntactically 
invalid to do so. 

Another type of remaps is one that remaps a previously declared structure. In this case, the addresses of 
the remap structure will begin at the address of the remapped structure. 

Example 

DECLARE 

1 SAVE.AREA.CHARS REMAPS S A. SECOND. ITEM 

2 SA.NAME CHARACTER(30), 

3 (SA.PACK.ID, 

SA.FAMILY.NAME 

SA.OFFSPRING NAME) CHARACTER(IO), 
2 SA.OWNER.NAME CHARACTER(14);% 

% THE RIGHTMOST 156 CHARACTERS OF SA.SECOND.ITEM ARE NOT REMAPPED HERE 

REVERSE 

"REVERSE" is an attribute that may be applied to a remapping simple item or structure. The presence of 
this reserved work causes the address associated with a < declared identifier) to be the normally-calculated 
address minus its declared length. 

For example, suppose a programmer wishes to specify a structure that describes the top memory and wants 
to list the < identifiers from the top of memory downward. The following could be done: 
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DECLARE 

1 TOP.OF.MEMORY REMAPS BASE.ZERO REVERSE, 

2 FILLER BIT(32), 

2 ADDR.INTERRUPT.QUEUE BIT(553), 

2 ADDR. SAVED. A. STACK BIT(240), 

2 ADDR.GISMO. WORK. SPACE BIT(384), 

2 ADDR.TEMP.FIB BIT(920), 

2 ADDR.TRACE.SPACE BIT(2232), 

3 ADDR.TRACE.CODE BIT(24); 

These < identifiers could then be used in MIL statements as follows: 

MOVE ADDR.INTERRUPT.QUEUE TO Y 
EXTRACT ADDR.TRACE.CODE FROM T TO X 
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7. REGISTERS AND SCRATCHPAD 



GENERAL 

This section is intended only as a brief overview of the registers within the processor. It is assumed that 
the reader is familiar with the contents of the B 1700 Systems Reference Manual (form 1057155). (See 
also Appendix B in this manual). 

NOTE 

The most-significant (left-most) bit in any register is 
identified in the MIL syntax as bit (zero), the next 
most-significant as bit 1 , etc. This is particularly 
advantageous in a bit-addressable machine since, for 
software purposes, it is often desirable to think of a 
register as being an extension of main memory. It 
should be noted that this convention is at variance 
with the hardware bit numbering convention where, 
generally, all bits are numbered right to left, through 
N. This difference has particular significance when 
any bit data is to be OR'ed into the M register at 
run time. 

REGISTER GROUPS 

The registers briefly described in this section are divided into the following logical groups: 

Active registers 
Result registers 
Scratchpads 
Constant registers 
Input/Output registers 
Condition registers 
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Sourcel & Sink 



X 

Y 

T 

L 

A 

M 

BR 

LR 

FA 

FB 

TAS 

CP 

*MSMA 

*MBR 



4-bit Source & Sink 



TOPM 



T subregisteir 




4-bit source & sink 


TA TB TC TD TE 


TF 



L subregister 




4-bit source & sink 


LA LB LC LD LE 


LF 



FB subregister 



source & sink 



FU FT FL 





C 


subregister 




source & 


sink 






CA 


CB 


CC 


•CD 


**CP 



* MSMA, TOPM, MBR and the low order 3 bits of CD are not 
physically present in the S-Memory Precessor. When addressed 
as a source they will yield a binary value of zero. When 
addressed as a sink (destination) the data is lost. 

** CPU, a 2-bit subregister of CP, is not addressable as a 
source or a sink. 
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RESULT REGISTERS 



SCRATCHPAD 



Source 



SUM 

CMPX 

CMPY 

XANY 

XEOY 

MSKX 

MSKY 

OXRY 

DIFF 



Single Scratchpad 



Double Scratchpad 





CONSTANT REGISTERS 



INPUT/OUTPUT REGISTERS 



Source 



MAXS 
MAXM 



Source 


Sink 


Source & Sink 


U 


CMND 


DATA 



CONDITION REGISTERS 



4-bit Source 



BICN 

FLCN 

*INCN 

XYCN 

YXST 



INCN is not physically present on the 
S-Memory Processor. When addressed as 
a source it yields a binary value of 0. 
When addressed as a sink (destination) 
the data is lost. 
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kBETICAL 


, LISTING OF REGISTERS 


Name 


Length 
In Bits 


Source 
Sink 


A 


* 


so & sk 


BICN 


4 


source 


BR 


24 


so &sk 


C 


24 


— 


CA 


4 


so & sk 


CB 


4 


so &sk 


CC 


4 


so & sk 


CD 


4 


so & sk 


CMND 


24 


sink 


CMPX 


24 


source 


CMPY 


24 


source 


Console 
Switches 


24 


source 


Control 
Memory 


16-bit 
words 


so &sk 


CP 


8 


so & sk 


CPL 


5 


so & sk 


CPU 


2 


— 


CYD 


1 


— 


CYF 


1 


— 


CYL 


1 


-- 


DATA 


24 


so & sk 


DIFF 


24 


source 


F 


48 






AND KEY CONCEPTS 

Note 

Control Memory Micro-instruction Address 
* 24 (1726), 19 (S-l), 20 (S-2) 

boolean conditions 

Base Register or low address 
S-Memory protection 

Control; not addressable as a unit 

sub field of C; general purpose 

sub field of C; general purpose 

sub field of C; interrupts and flags 

subfield of C; interrupts and flags 

I/O Command Register 

Result: complement of X; masked by CPL 

Result: complement of Y; masked by CPL 

the 24 toggle switches located on the Console 
front panel 

Location of micro-instructions on M-Memory 
Processor 

Control Parallel; subfield of C 

Control Parallel Length; subfield of CP 

Control Parallel Unit; subfield of CP 

Carry Difference or carry of borrow 

Carry Flip-Flop; subfield of CP 

Carry Level or carry of sum ; masked by CPL 

I/O Data Register 

result of X-(Y + CYF); masked by CPL 

Field in S-Memory; FA and FB concatenated 
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Length 


Source 


Name 


In Bits 


Sink 


FA 


24 


so & sk 


FB 


24 


so & sk 


FL 


16 


so & sk 


FT 


4 


so & sk 


FLC 


4 


so & sk 


FLD 


4 


so & sk 


FLE 


4 


so & sk 


FLF 


4 


so & sk 


FLCN 


4 


source 


FU 


4 


so & sk 


INCN 


4 


source 



LA 
LB 
LC 
LD 
LE 
LF 
LR 

M 
MBR 

MAXM 



24 

4 
4 
4 
4 
4 
4 
24 

16 

24 

24 



so &sk 

so & sk 
so & sk 
so & sk 
so & sk 
so & sk 
so & sk 
so & sk 

so & sk 
so &sk 

source 



Note 

Field Address in S-Memory 

Concatenation of S-Memory Field Unit (FU), 
Field Type(FT), and Field Length(FL) 

Field Length in S-Memory 

subfield of FB 

subfield of FL 

subfield of FL 

subfield of FL 

subfield of FL 

boolean Field Length Conditions 

S-Memory Field Unit size; subfield of FB 

boolean dispatch Interrupt Conditions 
M-Memory Processor 

Local register also used in DISPATCH, OVERLAY, 
TRANSFER.CONTROL, READ/WRITE MSML 
AND S-MEMORY ACCESS 

subfield of L 

subfield of L 

subfield of L 

subfield of L 

subfield of L 

subfield of L 

Limit Register or high address S-Memory 
protection 

current Micro-instruction register 

Main Memory Micro-instruction Base 
Register; not on S-Memory Processor 

hardwired Constant; number of 16-bit 
words of M-Memory 
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Name 


Length 
In Bits 


Source 
Sink 


MAXS 


24 


source 


MSKX 


24 


source 


MSKY 


24 


source 


MSMA 


16 


so & sk 


Main 
Memory 


- 


— 


NULL 


24 


so & sk 


PERR 


4 


source 



READ 



24 



SFL 


16 


S0-S15 


48 


S15A-S15B 


48 


S-Memory 


- 


SU 


4 


SUM 


24 


T 


24 


TAS 


24 


TA 


4 


TB 


4 


TC 


4 


TD 


4 


TE 


4 


TF 


4 



source 



so & sk 
so & sk 



source 
so & sk 

so & sk 
so & sk 
so & sk 
so & sk 
so & sk 
so &sk 
so & sk 



Note 

Constant; size in bits of available S-Memory 

Result; mask of X; length by CPL 

Result; mask of Y; length of CPL 

Control Memory addressed by the A register; 
M-Memory Processor only 

S-Memory 

always zero 

Parity Error Register; reflects error conditions 
from S & M-Memory, and cassette 

Console switch position; reads S-Memory 
addressed by FA to Console lights (A on 1714) 

subfield of SOB corresponding to FL in FB 

Double Scratchpad Words 

Single Scratchpad Words of SI 5 

Main Memory 

subfield of SOB corresponding to FU in FB 

Result (X + Y + CYF) length; masked by CPL 

Transform - will ROTATE, SHIFT or EXTRACT 
bits; used also in S-MEMORY ACCESS and 
TRANSFER.CONTROL 

Top of A Register- Stack 

subfield of T 

subfield of T 

subfield of T 

subfield of T 

subfield of T 

subfield of T 
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Name 



TOPM 



Length 
In Bits 



Source 
Sink 

so & sk 



u 


16 


source 


WRIT 


24 


— 


X 


24 


so & sk 


XANY 


24 


source 


XEOY 


24 


source 


XORY 


24 


source 


XY 


48 


source 


XYCN 


4 


source 


XYST 


4 


source 


Y 


24 


so & sk 



Note 

Top of Control Memory; not on S-Memory 
Processor 

cassette input only 

Console position switch; writes Console 
switches to address of memory contained 
in FA (A on 1714) 

input to Function Box 

Result; X and Y; length by CPL 

Result; X EOR Y; length by CPL 

Result; X OR Y; length by CPL 

X AND Y concatenated 

boolean XY Conditions 

boolean XY States 

input to Function Box 
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ACTIVE REGISTERS 

The following are descriptions of the active registers: 

X and Y Registers 

The X and Y registers (both of which are 24 bits wide) are used as inputs into the 24-bit Function Box 
(see below). All functions are performed under control of the C (Control) register, which regulates the 
length of the operation, class of arithmetics, and least-significant carry input. The X and Y registers are 
capable of being shifted or rotated individually or as a unit and may receive or transmit data from or to 
main memory. 

Field (F) Register 

The F register is divided into FA and FB, each sub-register being 24 bits wide. The FA (Field Address) 
portion is used to address main memory. FB is divided into FU (Field Unit, consisting of four bits used 
to indicate arithmetic unit size; FT (Field Type), a general-purpose 4-bit field; and FL (Field Length), 
consisting of 16 bits used to indicate the length of fields in main memory. FL is subdivided into FLC, 
FLD, FLE and FLF, each four bits in length. 

Local (L) Register 

The L register is 24 bits wide and is subdivided into LA, LB, LC, LD, LE and LF, each four bits in length. 
L and its subdivisions are generally used to temporarily hold the contents of other processor registers. 
It is also used as a source and destination for main memory access and has implicit use in the DISPATCH, 
OVERLAY, READ/WRITE MSML and TRANSFER CONTROL micro-instructions. 

Transform (T) Register 

The T register is a 24-bit transformation register used extensively for interpretation of virtual-language 
operators. It is subdivided into TA, TB, TC, TD, TE and TF, each four bits in length. T has strong 
SHIFT and EXTRACT logics associated with it and is the principal formatting register of the processor. 
This register also has the capability of receiving or transmitting data from and to main memory. 

Micro-Instruction (M) Register 

The M register is a 16-bit register which holds the micro-operator for decoding and subsequent execution 
by the hardware. It is addressable as a source and sink register; when used as a sink register the source is 
bit-ORed with the upcoming M-op, except in TAPE mode. 

Base (BR) and Limit (LR) Registers 

The BR and LR registers are each 24 bits wide and are used to hold the main memory base and limit 
addresses for the currently active main memory process. The M- Memory processor hardware uses these 
registers to determine if addresses in the Field Address (FA) register are within the base/limit boundaries. 
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Address (A) Register 

The A register is the microprogram address register which contains the bit address of the next micro- 
instruction. Values in the A register are always MOD 16; i.e., the low-order four bits are always zero. 
It is capable of addressing 16,384 micro-instructions located in either control memory or main memory 
or both. The A register is automatically incremented to the next micro-instruction before the current 
micro-instruction is executed. It is also capable of having any value from to 4,095 added to or sub- 
tracted from it to facilitate microcode branching. 

A Stack (TAS) 

The A stack is a 32-element-deep, 24-bit wide, push-down, pop-up memory, i.e., a last-in-first-out (LIFO) 
storage structure. The A stack is used to nest microroutine linkages and allows highly shared routines, 
thus reducing control memory requirements. Although the A stack was intended for microcode addresses, 
it has been made 24-bits wide to allow for any operand storage. 

NOTE 

The S-Memory Processor A stack has only 1 6 storage 
elements. 

Top of Control Memory (TOPM) Register 

M-Processor Only 

The TOPM register is four bits wide and is used to determine which memory (control or main) contains the 
next micro-instruction. If the A register is equal to or greater than (TOPM*512*16), the next micro- 
instruction will be fetched from main memory rather than control memory. The TOPM register is address- 
able as a source or as a sink (destination). The fetch from S-Memory takes place at address 
A+MBR. 

Memory Base (MBR) Register 

M-Processor Only 

The MBR register is used with the A and TOPM registers to obtain the main memory address of the next 
micro-instruction. (See above formula). The MBR register is addressable as both a source and as a sink. 

Control (C) Register 

The C register is a 24-bit control register for the microprocessor. It contains the 24-bit Function Box 
controls and carry input plus some of the processor interrupts and flags. It is subdivided into CA, CB, 
CC, CD, each four bits wide; and CP, eight bits wide. CA and CB may be used as general-purpose regis- 
ters. CC and CD represent processor interrupts and flags (see discussion under Condition Registers 
below). CP contains Function Box controls: CYF (0 bit of CP), CPU (1 and 2 bits of CP), and CPL 
(3,4,5,6, and 7 bits of CP). CYF (Carry Flip Flop) notifies the Function Box that a previous unit carry 
must be added to its summary results. CPU (Control Parallel Unit) notifies the Function Box of the type 
of unit contained in X and Y: 00 = binary, 01 = 4-bit decimal. CPL (Control Parallel Length) specifies 
the Width, in bits, of the Function Box and Read/Write micro-instructions. 
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Combinatorial Logic or Functional Box 

The Combinatorial Logic, often called the Function Box, produces the Result Registers. Inputs are the 
X register, the Y register and the Carry Flip-Flop (CYF). The inputs are combined under control of the 
Conrol Parallel Unit (CPU) register and the Control Parallel Length (CPL) register. When values are loaded 
into the X and Y registers, a large collection of output values and comparisons (called Result Registers) is 
made available to all subsequent micro-instructions. 

RESULT REGISTERS 

The Result registers are outputs from the 24-bit Function Box. Their contents are produced immediately 
and automatically from the inputs to the Function Box (X, Y and CYF) and cannot be changed except by 
changing inputs or by changing CPU (Control Parallel Unit) or CPL (Control Parallel Length). If the value 
of CPL is less than 24, then the (24-CPL) most-significant bits of all Result registers will be zero. 
These registers are source registers only and therefore cannot be used as the sink (destination) register in 
a MOVE or in any other instruction. 

XORY Result Register 

This register contains the INCLUSIVE OR of the X register combined with the Y register. This is a bit by 
bit operation with corresponding pairs of bits treated independently. 

XANY Result Register 

This register contains the AND of the X register combined with the Y register. This is the logical product 
of the X register and the Y register. Corresponding pairs of bits are treated independently. 

XEOY Result Register 

This register contains the EXCLUSIVE OR of the X register and Y register. 

CMPX Result Register 

This register contains the l's complement of the X register. 

CMPY Result Register 

This register contains the 1 's complement of the Y register. 

MSKX Result Register 

Masked X contains the low-order bits of the X register. The value of CPL determines the number of bits 
placed in MSKX. All other high-order bits are zero. If CPL is equal to 24, then MSKX is identical to the 
X register. 

MSKY Result Register 

Masked Y contains the low-order bits of the Y register. The value of CPL determines the number of bits 
placed in MSKY. All other high-order bits are zero. If CPL is equal to 24, MSKY is identical to the Y 
register. 
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SUM Result Register 

SUM is the decimal or binary value (determined by CPU) of the X register plus the Y register plus the 
CYF register. Corresponding pairs of bits are grouped by CPU control, and grouping may be binary or 
4-bit decimal. If the sum of (X + Y + CYF) is larger than the size specified by CPL, then the CYL7 
(Carry Level) will be true (one). CYL may be gated into CYF through use of the CARRY micro-instruction. 

Difference (DIFF) Result Register 

DIFF stores the amount resulting from the subtraction of the sum of the contents of the Y and CYF 
registers from the contents of the X register. The contents of the CPU register determine whether the 
subtraction is decimal or binary. Corresponding pairs of bits are grouped by CPU. If the difference is 
negative, X-(Y+CYF) 0, then Diff Result will be in 2's complement form of 10's complement form 
depending upon the mode, either binary or decimal respectively; and CYD (Carry Difference) will be 
true (one). 

NOTE 

The CYD register is not conditioned by CPL; it is 
always based on a 24-bit comparison. The programmer, 
therefore, must know what is in the high-order positions 
of the X register and the Y register if CPL is less than 

24. 

SCRATCHPAD 

The scratchpad can be used for temporary storage of active registers. The scratchpad may be addressed 
as sixteen, 48-bit double words or thirty-two, 24-bit words. 

Scratchpad Words - 24 Bits Each 



Double Scratchpad Words 



SOA S4A 


S8A 


S12A 


SOB S4B 


S8B 


S12B 


SIA S5A 


S9A 


S13A 


SIB S5B 


S9B 


S13B 


S2A S6A 


S10A 


S14A 


S2B S6B 


S10B 


S14B 


S3A S7A 


sua 


S15A 


S3B S7B 


sub 


S15B 


48 Bits Each 






SO S4 


S8 


S12 


SI S5 


S9 


S13 


S2 S6 


S10 


S14 


S3 S7 


Sll 


S15 



(Sn = SnA and SnB concatenated, where n = through 15) 
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CONSTANT REGISTERS 

The following is a description of the constant registers. 

Maximum Main Memory (MAXS) Register 

The 24-bit MAXS register is set by the field engineer and contains the value of the maximum installed 
number of main memory bits. -It is addressable as a source only. Main memory addresses begin at zero. 
The lower 15 bits are always zero, i.e., MAXS has a 4096 byte (32K bit) resolution. 

Maximum Control Memory (MAXM) Register 

The 24-bit MAXM register is set by the field engineer and contains the value of the maximum installed 
number of control memory words, each word comprising 16 bits. It is addressable as a source only. The 
lower 10 bits are always zero, i.e., MAXM has a 1024 word resolution. On the B 1710 series MAXM 
will always contain zero. 

NULL Register 

The NULL register is a 24-bit, addressable field of zeros. It may be addressed as source of sink; in the 
latter case it accepts the data but remains zero. 

INPUT/OUTPUT REGISTERS 

The following is a description of the Input/Output registers. 

Console.Switches 

M-Processor Only 

This 24-bit register reflects the current state of the 24 Console Switches on the processor. 

Console Cassette Tape Input (U) Register 

The U register accumulates the data read from the tape cassette on the Console control panel. It is 
addressable as a source in the RUN mode with the MOVE REGISTER micro-instruction and in the TAPE 
mode with the MOVE 24-BIT LITERAL micro-instruction. (See MIL Statements: LOAD.MSMA.) It 
is not addressable as a sink. 

Command (CMND) Register 

The CMND register is used to transfer commands to the I/O controls. It is 24 bits wide and is address- 
able as a sink only. 

Data Register 

The DATA register is used to transfer data to and. from the I/O controls and their peripherals. It is 24 
bits wide and is addressable as a source or as a sink. 
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CONDITION REGISTERS 
Introduction 

There are five Condition registers: 

Binary Conditions (BICN) 

Field Length Conditions (FLCN) 

Interrupt Conditions (INCN) 

X AND/OR Y registers(s) Conditions (XYCN) 

X AND/OR Y registers(s) States Conditions (XYST) 

Each Condition register consists of four bits. The bits are identified from left to right and are assigned 
the position numbers through 3, with being the most-signifieant bit. 

All Condition registers are source registers only. They may be moved to another register or tested, using 
the IF and SKIP instructions, for their current contents. They may not be the sink (destination) register of 
any micro-instruction. 



BIT 



BICN 



XYCN 



XYST 



FLCN 



INCN 






LSUY 


MSBX 


LSUX 


FL = SFL 


NO-DEVICE 


1 


CYF 


X = Y 


ANY.INTERRUPT 


FL SFL 


HI-PRIORITY 


2 


CYD 


X Y 


YNEQO 


FL SFL 


INTERRUPT 


3 


CYL 


X Y 


XNEQO 


FL NEQ 


LOCKOUT 



Binary Conditions (BICN) Register 

LSUY is true if the least-significant unit of the Y register is 1 and the Control Parallel Unit (CPU) register 
specifies binary (CPU = 0); or 9 and the CPU register specifies decimal (CPU = 1). 

The Carry Flip-flop (CYF) register indicates the value of the carry-in in the Control Parallel (CP) register . 
The CYF register may be manipulated as part of the CP register and by the CARRY instruction. 

The Carry Difference (CYD) register is true if X-(CYF + Y) 0. This condition is not affected by CPL, 
i.e., a 24-bit compare is always made. 

The Carry Level (CYL) register is true if (X + Y + CYF), limited by the Control Parallel Length (CPL) 
register, overflows. 

XY Conditions (XYCN) Register 

MSBX is true if the most-significant bit of the X register, as determined by the Control Parallel Length 
(CPL) register, is a 1. 

NOTE 

The comparisons of the X register to the Y register are 
not affected by CPL; they are always 24-bit compares. 
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XY States (XYST) Register 

LSUX is true if the least -significant unit of the X register is 1 and the Control Parallel Unit (CfcU) register 
specifies binary (CPU = 0); or is 9 and the Control Parallel Unit (CPU) register specifies decimal (CPU = 1). 
The comparisons of the X register or the Y register to zero are not affected by CPL; all 24 bits of the X 
register and/or the Y register are used in the comparisons. 

Any. Interrupt Bit 

This bit is true if any of the following conditions in registers CC, CD, of INCN (M-Memory Processor) 
are true: 

Event Register (Bit Position) 

MISSING DEVICE INCN (0) 

PORT INTERRUPT INCN (2) 

I/O SERVICE REQUEST INTERRUPT CC (2) 

CONSOLE INTERRUPT CC (3) 

MAIN MEMORY READ PARITY 

ERROR INTERRUPT CD (0) 

MEMORY WRITE/SWAP ADDRESS 

OUT OF BOUNDS INTERRUPT CD (3) 

The CC and CD registers are both 4-bit source and sink (destination) registers within the C register. The 
bits in each are numbered through 3, with bit being the most significant. They have been assigned 
the following uses and meanings: 

CC (0) STATE LIGHT 

CC ( 1 ) TIMER INTERRUPT 

CC (2) I/O SERVICE REQUEST INTERRUPT 

CC (3) CONSOLE INTERRUPT 

CD (0) MAIN MEMORY PARITY ERROR 

CD ( 1 ) MAIN MEMORY WRITE/SWAP ERROR OVERRIDE 

CD (2) MAIN MEMORY READ OUT OF BOUNDS ERROR 

CD (3) MAIN MEMORY WRITE/SWAP OUT OF BOUNDS ERROR 

All bits in the CC and CD portions of the C register, once set, remain set even though the conditions that 
caused them to be set may no longer exist. Therefore, if it is desired to clear any of these bits to zero, 
this must be done explicitly. CD (1), CD (2), and CD (3) of the C register are always zero in the S-Memory 
Processor but still may be addressed and tested. 
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Console Interrupt (CC(3)) 

This bit is set when the interrupt toggle switch on the Console control panel is turned on. It remains set 
as long as the switch is on. It can be reset programmatically but not by turning the Console toggle switch 
off. This bit is also reported in ANY.INTERRUPT when it is on. 

Main Memory Read Parity Error Interrupt (CD(O)) 

This bit is set when a main memory parity error is detected during a READ or a READ portion of a SWAP 
operation or when an attempt is made to access non-existent main memory. 

Main Memory Address Out-of-Bounds Override (CD(1)) 

M-Processor Only 

This bit is tested if the Field Address (FA) register setting is less than the Base Register (BR) setting or 
greater than or equal to the Limit Register (LR) setting; then WRITE or SWAP operations will be inhibi- 
ted unless this bit is set (one). The state of this bit does not affect the setting of CD (2) or CD (3). 

Read Address Out-of-Bounds Interrupt (CD(2)) 

M-Processor Only 

This bit is set when a READ operation is attempted and the Field Address (FA) register setting is either 
less than the Base Register (BR) setting or greater than or equal to the Limit Register (LR) setting. The 
READ operation is not inhibited. 

Write/Swap Address Out-of-Bounds Interrupt (CD(3)) 

M-Processor Only 

This bit is set when a WRITE or SWAP operation is attempted and the Field Address (FA) register setting 
is either less than the Base Register (BR) setting or greater than or equal to the Limit Register (LR) set- 
ting. This bit, when on, is also reported in ANY.INTERRUPT. 

Field Length Conditions (FLCN) Register 

All conditions are based upon comparisons between the 1 6 bits of the FL register and either zero or the 
corresponding low-order 16 bits of the first word in the Scratchpad (SOB). 

Interrupt Conditions (INCN) Register 

M-Processor Only 

NO DEVICE is true if an interrupt message is present in the dispatch buffer for a port or channel which 
does not have a device attached to it. This condition is normally cleared by the processor with a DIS- 
PATCH READ AND CLEAR instruction. 

HI PRIORITY is true if there is a high-priority message present in the dispatch buffer. 
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INTERRUPT is true if there is a message present in the dispatch buffer for the processor. This condition 
is normally cleared by a DISPATCH READ AND CLEAR instruction. It is also reported in ANY.INTER- 
RUPT. 

LOCKOUT is true if the interrupt system is locked (marked as "in use"). 

REGISTER DESIGNATIONS AND AREAS OF APPLICATION 

The following is a list, arranged by areas of application, of registers and their associated designations. 

MICRO-INSTRUCTION CONTROL 

A (Micro-instruction Address) 

M (Current Micro-instruction) 

TAS (Top of Address Stack) 

TOPM (Logical Top of M-Memory) 

MBR (Micro-instruction Base Register) 

S-MEMORY CONTROL 

BR (Base Register) 

LR (Limit Register) 

FA (Field Address) 

FL (Field Length) 

CP (Control Parallel) 

INTERRUPT CONTROL 

CC 
CD 

INCN 

PARALLEL WIDTH CONTROL 

C 
CP 
CPL 
CPU 

ORGANIZATION OF FIELDS AND SUBFIELDS 

The following is a description of the organization of register fields and subfields, expressed in the notation 
of MIL structured data declarations. 
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1 C BIT(24), 

2 CA BIT(4), 

2 CB BIT(4), 

2 CC BIT(4), 

2 CD BIT(4), 

2 CP BIT(8), 

3 CYF BIT(l), 

3 CPU BIT(2), 

3 CPL BIT(5); 



F BIT(48), 




2 FA 


BIT(24), 


2 FB 


BIT(24), 


3 


FU BIT(4), 


3 


FT BIT(4), 


3 


FL BIT(16), 




4 FLC BIT(4), 




4 FLD BIT(4), 




4 FLE BIT(4), 




4 FLF BIT(4); 



NOTE: C does not exist as a composite, 
only as sub fields. 



1 



L 


BIT(24), 


2 


LA BIT(4), 


2 


LB BIT(4), 


2 


LC BIT(4), 


2 


LD BIT(4), 


2 


LE BIT(4), 


2 


LF BIT(4); 



1 T BIT(24) 


? 


2 TA 


BIT(4), 


2 TB 


BIT(4), 


2 TC 


BIT(4), 


2 TD 


BIT(4), 


2 TE 


BIT(4), 


2 TF 


BIT(4); 
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8. MIL STATEMENTS 



INDEX TO STATEMENTS 



Following is an alphabetical list of MIL statements found in this section. 



Statement 

ADD SCRATCHPAD 

ADJUST LOCATION 

AND 

ASSIGN 

BEGIN 

BIAS 

BRANCH.EXTERNAL 

CALL 

CALL.EXTERNAL 

CARRY 

CASSETTE 

CLEAR 

CODE. SEGMENT 

COMPLEMENT 

COUNT 

DEC 

DEFINE 

DEFINE.VALUE 
* DISPATCH 

EMIT.RETURN.TO.EXTERNAL 

ELSE 

END 

EOR 

EXIT 

EXTRACT 

FA.POINTS 

FINI 

GOTO 

HALT 

IF 

INC 

JUMP 

LIT 

LOAD 
*LOAD.MSMA 

LOAD.SMEM 

LOCAL.DEFINES 

MACRO 



Page 


Statement 


Page 


8-2 


MAKE.SEGMENT.TABLE.ENTRY 


8-59 


8-3 


MICRO 


8-60 


8-4 


*M.MEMORY.BOUNDARY 


8-61 


8-6 


MONITOR 


8-62 


8-7 


MOVE 


8-63 


8-9 


NOP 


8-65 


8-11 


NORMALIZE 


8-66 


8-12 


OR 


8-67 


8-13 


*OVERLAY 


8-69 


8-14 


PAGE 


8-70 


8-15 


POINT 


8-71 


8-16 


PROGRAM.LEVEL 


8-72 


8-17 


READ 


8-73 


8-18 


REDUNDANT.CODE 


8-75 


8-20 


RESERVE.SPACE 


8-76 


8-22 


RESET 


8-77 


8-23 


ROTATE 


8-78 


8-24 


SEGMENT 


8-79 


8-25 


SET 


8-80 


8-29 


SHIFT/ROTATE T 


8-82 


8-27 


SHIFT/ROTATE X/Y/XY 


8-84 


8-30 


SKIP 


8-85 


8-31 


S.MEMORY.LOAD 


8-87 


8-33 


STORE 


8-88 


8-34 


SUBTITLE 


8-89 


8-36 


SUBTRACT SCRATCHPAD 


8-90 


8-37 


*SWAP 


8-91 


8-38 


TABLE 


8-92 


8-39 


TITLE 


8-93 


8-40 


TRANSFER.CONTROL 


8-94 


8-46 


WRITE 


8-95 


8-47 


WRITE.STRING 


8-97 


8-48 


XCH 


8-99 


8-49 






8-50 






8-52 






8-53 






8-55 







♦Available on B 1720 systems only. 
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ADD SCRATCHPAD 

Syntax 

ADD ^{scratchpad • word) ^» TO FA- 

Semantics 



This instruction adds the left half of any scratchpad word (SOA ... SI 5A) to the Field Address (FA) regis- 
ter. The result is placed in FA; the contents of { scratchpad.word) remain unchanged. (See also- 
SUBTRACT SCRATCHPAD.) 



Example 

ADD S9A TO FA 
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ADJUST 
Syntax 

ADJUST LOCATION TO 




(literal ) 



H 



Semantics 

This pseudo-operation adjusts the < physical, code, address) of the compiler. The value of the < physical, 
code.address) specifies the location (control memory address) into which the next generated micro- 
instruction is to be placed, generally by a user-developed loader. (See also Segmentation: Label Addresses.) 

LOCATION PLUS (+) OR MINUS (-) increments/decrements the (physical.code.address) by the value of 
the < literal). If this option is not used, the < physical.code.address) is set to the value of the < literal). 



The < literal) must have a value of MOD 1 6. 



NOTE 



This instruction is generally used to compensate for 
disposable loader routines. 



Examples 



ADJUST LOCATION TO @100@ 
ADJUST LOCATION TO LOCATION + 32 
ADJUST LOCATION TO LOCATION MINUS 128 
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AND 

Syntax 



AND 



'{source • sink ■ register) ■ 



WITH- 



(source- register) 
(literal) 



J 



Semantics 

This instruction logically ANDs the contents of a 4-bit source and sink (destination) register with the bit 
configuration of the < literal) or the contents of a 4-bit source register. The result is placed in < source, 
sink, register); the contents of (source, register) remain unchanged. (See also: OR and EOR.) 



The register may be any of the following: 

(so urce. sin k. regis ter) 

CA CB *CC *CD 

FT FU 

FLC FLD FLE FLF 

LA LB LC LD LE LF 

TA TB TC TD TE TF 

TOPM (available on B1720 only) 



( source.register) 

< source.sink. register) 

BICN 

FLCN 

INCH (available on B 1720 only) 

PERR (available on B1720 Model II only) 

XYCN 

XYST 



*CC and CD represent processor interrupts and flags 
The < literal) has a decimal range from to 15. 

Table 8-1: AND Truth Table 



Source . Sink . Register 


(Literal) or (Source. Register) 


Source . Sink . Register 





AND 





Yields 








AND 


1 


Yields 





1 


AND 





Yields 





1 


AND 


1 


Yields 


1 
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Example 



AND TB WITH 3 





TA 


TB 


TC 


TD 


TE 


TF 




T 


0000 


1010 


1111 


0011 


0001 


0010 


before (0AF312) 




-- 


0011 


- 


-- 


-- 


- 


literal (3) 


T 


0000 


0010 


1111 


0011 


0001 


0010 


after (02F312) 
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ASSIGN 
Syntax 



ASSIGN 



ARCHITECTURE.NAME. 
COMPILER. LEVEL 



{character ■ string) ■ 
(literal) 



-*- MCP. LEVEL 



-*- GISMO.LEVEL 



ATTR I B UTE < literal ) AS < identifier) 



J 



Semantics 



This statement assigns values to the various interpreter verification attributes. These attributes occupy 
fields in the IPB (Interpreter Parameter Block) of all interpreters. They are accessed at BOJ (Beginning of 
Job) time by the MCP and are used to verify that the proper interpreter has been chosen. 

The < characters tring) for ARCHITECTURE.NAME must be a string of 10 or fewer < character^. 

{literal) has a decimal range from to 255 for COMPILER. LEVEL, MCP.LEVEL, and GISMO.LEVEL; 
and from to 79 for ATTRIBUTE. 

Examples 

ASSIGN ARCHITECTURE.NAME = "GISMO.26" 

ASSIGN MCP.LEVEL = 197 

ASSIGN ATTRIBUTE 64 AS ITEM.01=1 
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BEGIN 
Syntax 



BEGIN- 



■ (label)- 



J 



Semantics 

This statement is paired with the END statement to combine MIL statements into logical blocks. If the 
BEGIN/END block is labeled, the MIL program listing will reflect the first ten letters of the block name on 
every line of the block (See example in Programming Technique section). 

The BEGIN/END block is useful in an IF statement when more than one statement is necessary following 
a condition. 

Example 

IF condition THEN 
BEGIN TRUE.CONDITION 

END TRUE.CONDITION 

ELSE 

BEGIN FALSE.CONDITION 

END FALSE.CONDITION 

BEGIN/END blocks may be nested to fifteen levels, meaning that no portion of a MIL program may reflect 
more than fifteen BEGIN's without matching END's. 

(See also: END statement and LOCAL.DEFINES statement) 
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Example 



BLOCK 

NESTING 
LEVEL 



1 
1 

2 
2 
2 
2 
3 
3 
3 
2 
2 
1 
1 



BEGIN BLOCK. 1 

BEGIN ANOTHER.BLOCK 



BEGIN INNERMOST.BLOCK 

END INNERMOST.BLOCK 
END ANOTHER.BLOCK 
END BLOCK. 1 
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BIAS 
Syntax 



BIAS BY 




Z3 — ""I 

-•►TEST »J 



n — ~j — 

' *► AND F— *J 



Semantics 

This instruction sets the Control Parallel Length (CPL) register and the Control Parallel Unit (CPU) register 
to values calculated from the given operands. 

NOTE 

All references to register S refer to the SFL or SFU 
registers in the second half of the first scratchpad word, 
e.g., the SFL (low order 1 6 bits) part of the SOB 
register. 

The CPU register will be set to 1 if the value of the Field Unit (FU) register is set to 4 or 8; otherwise 
CPU is set to 0. This is done for all variations of BIAS except BIAS BY S, which sets the CPU register 
from SFU rather than from the FU register. 

BIAS BY . . . sets the CPL register equal to 24 or to the value in the specified register if it is less than 
24. BIAS BY UNIT sets the CPL register equal to the FU register (4 for 4-bit decimal, 8 for 8-bit 
decimal, or any other value less than 1 6 for binary). 

If the TEST option is used the above actions are performed, and the next micro-instruction is skipped 
if CPL has not been set to zero. 



Examples 
BIAS BY F 

BIAS BY F AND CP 



This instruction sets the CPL register to 24 or to the value of the Field 
Length (FL) register, if it is less than 24. It also sets the CPU register 
equal to the unit in the FU register. 

This instruction sets the CPL register to 24, to the value in the FL 
register, or to the value in the CPL register, whichever is the smallest. 
It also sets the CPU register to the unit in the FU register. 
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BIAS BY UNIT This instruction sets the CPL register equal to the length of the unit of 

the type specified by the FU register. It also sets the CPU register equal 
to one unit of the type specified in the FU register, i.e., 4-bit decimal, 
8-bit decimal, or binary. 

NOTE 

In all cases except UNIT, CPU is set to 1 if FU (or 
SFU) is 4 or 8; otherwise CPU is set to 0. If UNIT 
is specified, CPL is set directly to the value in FU. 
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BRANCH.EXTERNAL 
Syntax 



BRANCH.EXTERNAL »*T0 •>► (label) U 



Semantics 

This instruction transfers control to the external segment location specified by < label). (See: Segmenta- 
tion.) 

(Label) must be associated with a run-time address that has a displacement from the BRANCH.EXTERNAL 
instruction of less than 4096 micro-instructions. 

NOTE 

If an external segment does not exist because $NO 
EXTERNAL has been specified, BRANCH. EXTER- 
NAL is equivalent to GO TO. 

Example 

BRANCH.EXTERNAL TO EXTERNAL.SEGMENT. LABEL 
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CALL 

Syntax 



CALL 



(label)- 



Semantics 

This instruction stores the address of the next micro-instruction in the A stack, then branches to the loca- 
tion specified by < label). 

The location specified by the label may be a maximum of 4095 micro-instructions away from the CALL 
instruction. 

Example 

CALL MULTIPLICATION. ROUTINE 
CALL M.IN.OUT 
CALL +ABC 
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CALL.EXTERNAL 

Syntax 

CALL.EXTERNAL »- (label) ■ 



Semantics 

This instruction stores the address of the next micro-instruction in the A stack, then branches to the 
external segment location specified by < label). (See: Segmentation.) 

< Label) must be associated with a run-time address that has a displacement from the CALL.EXTERNAL 
instruction of less than 4096 micro-instructions. 

NOTE 

If an external segment does not exist, becuase $NO 
EXTERNAL has been specified, CALL.EXTERNAL 
acts identically to CALL. 

Example 

CALL.EXTERNAL BEGINNING.OF.LOOP. 1 
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CARRY 

Syntax 



CARRY 



o- 
• 1 - 



SUM- 



-*► DIFFERENCE- 



Semantics 

This instruction sets, the Carry (CYF) register to either or 1. CARRY or CARRY 1 sets the CYF 
register to or 1 respectively. CARRY SUM sets the CYF register to the value of CYL single bit. 
CARRY DIFFERENCE sets the CYF register to the value of the Carry Difference (CYD) register: 

If: X>Y X=Y AND CYF=0 X==Y AND CYF=1 X<Y 



CYD is set to: 











1 



1 



The CYD register, unlike the CYL register is not conditioned by the CPL register. That is, all 24 bits of 
the X and Y registers are compared when setting CYF by the CYD register. The programmer should, 
therefore, know what is in the high-order position of the X and Y registers when using the CYD register 
if the CPL register is set to less than 24. 
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CASSETTE 
Syntax 



CASSETTE , — +- START- 
STOP— 



n 



I i^WHEN X t— »- EQLY r- 

' — •»" NEQY — ** 



Semantics 



This instruction causes the system cassette tape to start or stop a READ operation at the next inter-record 
gap. 

The information read from the cassette is loaded into the U register and remains there for a maximum of 
two clock cycles before the U register is cleared. 

NOTE 

The data on the cassette is duplicated every eight 
bits to ensure its validity. The cassette will discrimi- 
nate against parity incorrect data and, if necessary, 
use the duplicate eight bits. If both copies are in 
error, the load will be aborted. If the STEP-RUN- 
TAPE switch is in the TAPE position (see: LOAD. 
MSMA) and the START button is pushed, the 
successive 2-byte increments will be moved from 
the U register. If the instruction being executed 
is a 24-bit literal MOVE TO MSMA, then the next 
16 bits (2 bytes) that appear in the U register are 
loaded into control memory at the address indica- 
ted by the A register. The A register is then incre- 
mented by 1 . 

Example 

CASSETTE STOP 

CASSETTE STOP WHEN X NEQ Y 
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CLEAR 
Syntax 



r~~ — ~~~~ 

CLEAR l 1 — *• (register) r- 



•(scratchpad • word)- 



Semantics 

This instruction sets the specified register(s) or 24-bit scratchpad word(s) to zero. 

The following may be cleared: 

< register) ( scratchpad, word) 

A SOA 

BR 

CA CB *CC *CD CP CPU S15A 

FA FB FL FT FU 

FLC FLD FLE FLF SOB 

LA LB LC LD LE LF — 

TA TB TC TD TE TF TAS S15B 

TOPM (available on B1720 only) 

*CC and CD represent processor interrupts and flags 

Each register clear takes one clock cycle; each scratchpad word clear takes two clock cycles. 

NOTE 

MOVE NULL TO (register) will be generated for each 
register specified on B 1710 systems. 



Example 



CLEAR S10A 

CLEAR BR L CB S4B TOPM FU 
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CODE.SEGMENT 
Syntax 



CODE.SEGMENT- 



•{label)- 



Semantics 

See Segmentation: CODE.SEGMENT 
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COMPLEMENT 

Syntax 



COMPLEMENT (register) ((literal)) 











u 




1" 

1 *-*► AND (register) {( literal )) L -»' 





Semantics 

This instruction COMPLEMENTS (switches the state of) the specified bit. By using the options, more than 
one bit in any one register can be complemented with the same instruction IF ALL BITS ARE IN THE 
SAME 4-BIT REGISTER. (See also: SET and RESET.) 

The < register) may be any 4-bit source and sink (destination) register below: 

CA CB CC CD (CC and CD represent processor interrupts and flags) 

FT FU 

FLC FLD FLE FLF 

LA LB LC LD LE LF 

TA TB TC TD TE TF 

TOPM (available on B1720 only) 

It may also be the FL, FB, L, or T register: all bits must then be in the same 4-bit subfield. 

The literal has a decimal range from to 3 for a 4-bit register; from to 15 for the FL register; and from 
to 23 for the FB, L, and T registers. 



Example 



COMPLEMENT LD(0) AND L(13) 



LA 


LB 


LC 


LD 


LE 


LF 




0001 


0010 


0011 


1000 


0101 


0110 


before (123856) 


0001 


0010 


00111 


0100 


0101 


0110 


after (123456) 



3 4 



7 8 



11 
LD(0)- 



16 
.(13) 



17 18 



23 
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It should be noted that most registers can be addressed in either of two ways: 





LA 




LB 






LC 


LD 


LE 


LF 





3 







3 





3 


12 3 


3 


3 





... 3 


4 




7 


8 


... 11 


12 ... 15 


16 19 


20 . . . 23 



or 



L(0) 
LA(0) 



LD(0) 



or 



L(12) 



L(13) 
LD(1) 
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COUNT 
Syntax 



COUNT i m ~ FA 



UP 



L*-AND FL DOWN-lJ 



DOWN- 



FL- 



UP- 



DOWN- 



I *-AND FL 



•— -*-DOWN-*J 



X 



L-*- AND FA DOWN-*-" 



l—*-AND FA-i »-UP t-*J 

I — *- DOWN -*J 



BYt — *~ CPL 



^{literal) -i j-*> 

L*. BITS -J 



Semantics 

This instruction increments or decrements the designated registers by the value of the < literal) or the 
contents of the Control Parallel Length (CPL) register. If the value of < literal) is 0, the value contained 
in the CPL register is used. 

If the FA register is counted down, it may pass through (i.e., if FA=0 and is counted down by 1 , it 
will be set to hexadecimal FFFFFF). If the FL register is counted down, it will not become less than 0. 

If either the FA or FL register overflows, wraparound to or through will occur; e.g., if either is equal to 
the maximum value it can contain and is counted up by 1 , it becomes equal to 0. 

The < literal) has a maximum decimal value of 72. 
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Example 



Count FA Up and FL Down by 10 



FA 


0000 


1001 


1010 


0111 


1111 


1011 


before (09A7FB) 




-- 


-- 


- 


-- 


-- 


1010 


{literal) +A 


FA 


0000 


1001 


1010 


1000 


0000 


0101 


after (09A805) 





FL 



FL 



0000 


0000 


0000 


1000 


before (0008) 


- 


-- 


- 


1010 


{literal) -A 


0000 


0000 


0000 


0000 


after (0000) 



FA is counted up by decimal 10 (hexadecimal A), while FL is counted down by 8 to its minimum value. 
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DEC 
Syntax 



DEC. 



• (source • sink ■ register) ■ 



BY 



(source- register)- 
(literal) 



TEST 



ZJ 



Semantics 

This instruction decrements the contents of a 4-bit < source.sink.register) by the value of the < literal) or 
the contents of a 4-bit (source.register). The result is placed in < source.sink.register); the contents of 
isource.register) remain unchanged, (see also: INC.) 



The registers may be any of the following: 

< source.sink.register) 

CA CB *CC *CD 

FT FU 

FLC FLD FLE FLF 

LA LB LC LD LE LF 

TA TB TC TD TE IF 

TOPM (available on B 1720 only) 



(source.register) 

< source, sink, register) 

BICN 

FLCN 

INCN (available on B1720 only) 

XYCN 

XYST 



*CC and CD represent processor interrupts and flags 

The < literal) has a decimal range from to 15. 

If the TEST option is used and (source.sink.register) underflows (is decremented beyond 0, the smallest 
value it can contain), the next micro-instruction is skipped. If underflow does not occur or if the TEST 
option is not used, the next micro-instruction is executed. 

NOTE 

All 4-bit registers count modulo 1 6; e.g., if a register 
contains a value of and is decremented by 2, it 
underflows to a value of 14. 

Example 

DEC TB BY 7 

DEC FLD BY LC TEST 
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DEFINE 

Syntax 



DEFINE ► (identifier) =-, j— , j- 

l— ^(string)—** I — »- # — *J 



Semantics 



This declaration assigns a name ((identifier)) to a string of characters. Any subsequent reference to the 
(identifier) is replaced by the(string). The pound sign merely clarifies the end of the DEFINE (string)if 
present. 

< String) may be a scratchpad name (24 or 48-bit); a register name; a < literal); a part of one instruction; 
an entire instruction, part of which may have been previously DEFINED; or empty. It may neither 
begin with a pound sign (#) nor contain any embedded pound signs. 

The entire DEFINE declaration must be contained on one card, and all DEFINEs must be declared prior 
to any executable instruction. 

Nested DEFINEs are allowed up to 13 levels. 

Example 

DEFINE SOURCE.POINTER = S3# % LOAD F FROM SOURCE.POINTER 

DEFINE OP.REG = L % CLEAR OP.REG 

DEFINE TEST.OP = @80 0000@# % MOVE TEST-OP TO OP.REG 

DEFINE HINT = CC(3) % RESET HINT 

DEFINE IGNORE.HALT = RESET HINT % IGNORE.HALT 

DEFINE LAZY = WRITE 21 BITS FROM X INC FA AND DEC FL#% FINGER SAVER 
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DEFINE.VALUE 
Syntax 



DEFINE.VALUE 



• (identifier) = (literal) — 



::u 



- (literal) 



ZJ 



Semantics 

This instruction assigns the value of the (arithmetic, expression) to the < identifier). Any occurrence of the 
< identifier) in the program is replaced by its assigned value. 

DEFINE.VALUE creates a 24-bit < literal). Values less than zero are in 2's complement notation and are 
24 bits long. 

If defined < identifier) are used as < literals) in the < arithmetic. expression), they must be previously defined. 

Example 



DEFINE. VALUE AA = @50@ 
DEFINE B = AA + 1 
DEFINE C = AA - 3 
DEFINE.VALUE F03 = @( 1)0010® + 4 



% VALUE is hex 000050 
% VALUE is hex 000051 
% VALUE is hex 00004D 
% VALUE is hex 000006 
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DISPATCH 

(available only on B 1 720 systems with port interchange) 
Syntax 



DISPATCH . »~ LOCK 




' ► AND 



CLEAR 



Semantics 

This instruction sends a message (e.g. an I/O descriptor address) from the processor to a device on an I/O 
port. 

Before sending a message to a port, the processor should first attempt to gain control of the interrupt 
system with a DISPATCH LOCK. This is necessary because the interrupt system is shared by all ports. 

DISPATCH LOCK locks (marks as "in use") the interrupt system. If the interrupt system was already 
locked, the next micro-instruction is skipped. 

DISPATCH LOCK SKIP WHEN UNLOCKED locks the interrupt system and skips the next micro- 
instruction if the interrupt system is already unlocked. 

DISPATCH WRITE sends a 24-bit message to a port. Before a DISPATCH WRITE is executed, the L 
register must contain the 24-bit message; the seven least-significant bits of the T register must contain 
the destination port (bits 17-19) and channel numbers (bits 20-23). The contents of the L register are 
then stored in the Dispatch buffer (main memory locations 0-23), and the port and channel numbers 
are transferred to a hardware register (Dispatch register) in the port interchange. The contents of the 
L and T register remain unchanged. 

DISPATCH READ transfers both a 24-bit message from the Dispatch buffer to the L register, and the 
source port and channel numbers to the seven least-significant bits of the T register. 

NOTE 

If T (23) is found set after a DISPATCH READ and 
the source port is an I/O multiplexor, a main memory 
parity error was encountered during the fetch of an 
I/O descriptor address or an I/O descriptor, or during 
a RESULT SWAP operation. Consequently, the 
message transferred to the L register will be the address 
+24 of the parity error. 
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DISPATCH READ AND CLEAR does everything a DISPATCH READ will do and in addition clears the 
Interrupt Condition (INCN) register. That is, it resets all INCN bits to zero. 

Only the least-significant seven bits of the T register are involved in any DISPATCH operation. 

If the SKIP WHEN UNLOCKED option is used with any variant other than a DISPATCH LOCK, the 
next micro-instruction is skipped. 
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ELSE 

Syntax 



ELSE 1 j- 

— i*- (statement) — +* 



Semantics 

The ELSE statement is used in conjunction with the IF statement to indicate that a < statement) is to be 
executed on a condition False. For example: 

IF condition THEN 

statement 
ELSE 

statement 

The statement following the THEN clause will only be executed if the condition is true. Likewise, the 
statement following the ELSE clause is executed only if the condition is false. 

The IF statement may also contain a BEGIN/END block following the THEN clause, in which case the 
ELSE clause becomes part of the END statement (see: END). 

Examples 

a. If condition THEN 

statement 

ELSE 

statement 

b. IF condition THEN 
BEGIN 



END ELSE 
statement 

IF condition THEN 

statement 
ELSE 
BEGIN 



END 
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IF condition THEN 
BEGIN 



END ELSE 
BEGIN 



END 
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EMIT.RETURN.TO.EXTERNAL 
Syntax 



EMIT.RETURN.TO.EXTERNAL 



Semantics 



This instruction causes the compiler to emit the common code necessary to get back to the main segment 
from the external segment. The compiler automatically emits this code when the first CODE. SEGMENT 
statement is encountered. If the program requires the code to be emitted before the first CODE. SEGMENT 
is encountered, this statement can be used to emit the code. This code also includes the return code used 
when the segment is exited for the last time. (See: Segmentation.) 

RESTRICTION 

This statement cannot be used more than once in a 
program, and cannot be used after the occurrence 
of the first CODE.SEGMENT statement. 
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END 
Syntax 



END 



*• (label) t- 



ELSE- 



Semantics 

This statement is paired with the BEGIN statement to combine MIL statements into logical blocks. The 
END statement must have the same < label) as its matching BEGIN statement. 

The ELSE clause is used only when needed as part of an IF statement. For example: 



BLOCK 

NESTING 

LEVEL 





MIL STATEMENT 

IF condition THEN 

BEGIN TEST.TRUE.BLOCK 



END TEST.TRUE.BLOCK ELSE 
BEGIN TEST.FALSE.BLOCK 



END TEST.FALSE.BLOCK 

Good programming practice recommends that BEGIN's and matching END's start in the same column 
while the statements within the block should be indented to reflect the nesting level. (See also: BEGIN 
and LOCAL.DEFINES). 

Example 

IF LD(2) FALSE THEN 
BEGIN EMIT. INFO 

WRITE 16 BITS FROM T INC FA AND DEC FL 

MOVEXTOS7A 

SETCB(l) 
END EMIT.INFO ELSE 

MOVE Y TO S7B 
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EOR 

Syntax 



EOR 



-(source • sink • register) ■ 



WITH 



-i — ^- (source • register) — t- 

I ^ (lHarnlS «J 



-(literal) 



Semantics 

This instruction logically EXCLUSIVE ORs the bits in a 4-bit (source.register) with the value of the literal 
or the contents of a 4-bit < source.register). The result is placed in < source.sink.register); the contents of 
(source.register) remain unchanged. (See also: AND and OR.) 



The register may be any of the following: 

< source.sink.register) 

CA CB *CC *CD 

FT FU 

FLC FLD FLE FLF 

LA LB LC LD LE LF 

TA TB TC TD TE TF 

TOPM (available on B1720 only) 



< source, register) 

{ source, sink, register) 

BICN 

FLCN 

INCN (available on B1720 only) 

PERR (available on B1720 only) 

XYCN 

XYST 



*CC and CD represent processor interrupts and flags. 
The < literal) has a decimal range from to 15. 

Table 8-2 EOR Truth Table 



Source .Sink .Register 


( literal) 
Source. Register 


Source.Sink .Register 





EOR 





Yields 








EOR 


1 


Yields 


1 


1 


EOR 





Yields 


1 


1 


EOR 


1 


Yields 
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Example 



EOR TB WITH 3 





TA 


TB 


TC 


TD 


TE 


TF 






T 


0000 


0101 


1111 


0011 


0001 


0010 


before (05F31 2) 






-- 


0011 


- 


- 


-- 


- 


EOR (030000) 


T 


0000 


0110 


1111 


0011 


0001 


0010 


after (06F213) 
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EXIT 
Syntax 

EXIT — 



Semantics 

This instruction returns program control to the calling routine by causing the compiler to generate a MOVE 
TAS TO A operation. 

The top of the A stack (TAS) is moved to the ADDRESS (A) register, which is used by the hardware logic 
as the address of the next micro-instruction to be fetched. The stack is decremented automatically by the 
hardware after the move. 

NOTE 

MOVE TAS TO A may be used instead of EXIT 
with the same result. 
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EXTRACT 

Syntax 



EXTRACT 



TZ 



(arithmetic -expression) BITS FROM T {(literal)) 
(declared, identifier) FROM T 



U 



((literal))- 



•TO- 



L 
■T 

X 

Y 



Semantics 

This instruction isolates the specified bits from the T register and moves them to a distination register (L, 
T, X, Y). If a destination register is not specified, T is assumed. 

The value of the following combinations may not exceed 24 bits: 

(arithmetic, expression) +< literal) . 

DATA.LENGTH of < declared. identifier) 

DAT A. LENGTH of < declared, iden tifier)+(literal) 

DATA.LENGTH of < declared. identifier) + DATA.ADDRESS of < declared.identifier) 

NOTE 

If the starting bit for < declared.identifier) is not 
specified, its DATA.ADDRESS is used. 

Examples 



EXTRACT 


4 BITS FROM T(20) TO L 




DECLARE 






1 


STUFF REMAPS BASE.ZERO BIT 


(24), 


2 


ITEM.l BIT 


(4), 


2 


ITEM.2 BIT 


(127), 


2 


ITEM.3 CHARACTER 


(1); 



MOVE STUFF TO FA 

ADD BASE TO FA 

READ DATA.LENGTH (STUFF) BITS TO T 

EXTRACT ITEM.2 FROM T TO X 

EXTRACT ITEM.l FROM T(0) TO T 
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EXTRACT 4 BITS FROM T(20) TO L 





TA 


TB 


TC 


TD 


TE 


TF 




T 


0000 


0001 


0011 


1000 


1110 


0100 


before (0138E4 




LA 


LB 


LC 


LD 


LE 


T(20) 

LF 




L 


1001 


1110 


0011 


1001 


1111 


1100 


before (1E39FC) 


L 


0000 


0000 


0000 


0000 


0000 


0100 


after (000004) 



Register T remains unchanged while its four extracted bits are placed in the L register. The bits are right- 
justified; leading zeroes are added. 

NOTE 

EXTRACT BITS FROM T(23) TO a destination 
register may be specified, but the programmer must 
OR into the M register the number of bits to be 
extracted. Caution must be exercised, however, when 
ORing into the M register: the machine hardware 
instruction requires the right-bit pointer for the 
extraction field, not the left. The hardware also 
indexes the T register from 1 to 24, left to right, 
not to 23; the compiler performs this conversion. 
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FA.POINTS 

Syntax 

FA.POINTS TO ^(arithmeti&expressiori) *J 

Semantics 

This pseudo-operation does not generate any code. It merely informs the compiler of the current contents 
of FA. This information is then used when compiling the POINT constructs in the READ, WRITE and 
POINT instructions. 

The FA.POINTS and POINT constructs are provided so that the user may symbolically reference the 
memory structures declared in a declaration statement. Such references will show up in a cross-reference 
listing and can often result in automatic code changes when the declaration needs to be changed. 

Example 

DECLARE 

1 STRUCTURE, 

2 DATA.ABIT(IO), 

2 DATA.B CHARACTER(20), 

2 DATA.C FIXED; 

FA.POINTS TO DATA.A 

READ DATA. LENGTH (DATA.A) BITS TO X POINT FA TO DATA.B 

POINT FA TO STRUCTURE 

MOVE DATA.C TO FA 

WRITE DATA.LENGTH (DATA.C) BITS FROM Y POINT FA TO DATA.B 
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FINI 
Syntax 

FINI — 



Semantics 



This instruction signals the compiler that the end of the file of source images has been reached. It should 
be the last statement in the source program. 
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GOTO 

Syntax 



GOTO 



■(label)- 



Semantics 

This instruction transfers control to the location specified by < label). < Label) must be associated with a 
run time address that has a displacement from the GO TO instruction of less than 4096 micro-instructions. 

Example 

GO TO SORT. ROUTINE 
GO TO -LOOP. 1 
GO TO +LOOP.2 
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HALT 
Syntax 

HALT ^ 

Semantics 

This instruction brings the processor to an orderly halt. The settings of the register select dials determine 
the register displayed. 

Pressing the START pushbutton on the system Console will cause the processor to again begin executing 
micro-instructions. If the STEP/RUN switch is in the STEP position, only one micro-instruction is 
executed each time the START pushbutton is depressed. 
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[F 

Syntax 

FORMAT 1 : CONDITIONAL PROGRAM CONTROL 



■(register) ((literal))- 



' — *■ ( condition) 



c 



•TRUE 
FALSE 



3-*>THENy»-BEGIN- I -»-< 



statement) ■ 
statement) - 



END- 



ELSE 



.c 



BEGIN T »» (statement)- 



-•-END- 



(statement)- 



FORMAT 2 : CONDITIONAL COMPILATION CONTROL 



\?-^{module> option)- 



TRUE - 
FALSE 



-♦►THEN INCLUDE BEGIN 



£Z 



(statement)- 



* end t-H 



ELSE BEGIN 



-*- (statement) ■ 



END 



Semantics 

FORMAT 1 : CONDITIONAL PROGRAM CONTROL 

This instruction tests a bit(s) for TRUE (one) or FALSE (zero), If the test condition is met, either the 
specified single statement or the specified BEGIN/END statement(s) is executed. If the test condition 
is not met, a branch around the first BEGIN/END pair is taken, and the ELSE BEGIN/END statement(s) 
is executed. Logical operators are valid on the registers immediately following the IF, enabling more than 
one bit to be tested at the same time, but only if all of the bits are in the same 4-bit register. (See also: 
COMPLEMENT, SET and RESET.) 
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Logical operators are valid on the registers immediately following the IF, with the following restrictions: 

1 ) All registers logically related must be within the same 4-bit group: IF T(0) and T(3) is 
valid, IF T(2) and T(4) is not. 

2) Only two register elements may be logically related: IF T(2) or T(0) is valid, IF T(2) and 
T(l)andT(0)isnot. 

3) NOT logic may be applied anywhere: IF NOT ( L(3) or NOT L(0) ) is valid. 

The < register) may be any 4-bit source and sink (destination) register below: 

CA CB CC CD (CC and CD represent processor interrupts and flags) 

FT FU 

FLC FLD FLE FLF 

LA LB LC LD LE LF 

TA TB TC TD TE TF 

TOPM (available on B 1 720 only) 

The < register) may also be the FL, FB, L, or T register: all bits must then be in the same 4-bit subfield. 

The < literal) points to the bit position which is to be tested. It has a decimal range from to 3 for a 
4-bit < register); from to 15 for the FL register; and from to 23 for the FB, L and T registers. 

The condition may be any of the following conditions available from the condition registers: 
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EQL 
NEQ 
< 



■*-GTR 
-». > 
-*■ LSS 
-*-GEQ 



-•►LEQ 



-■►EQL 



-•►NEQ 
-*- < 

-»-GTR 
-*• > 

-»► LSS 
■*- GEQ 



-*► LEQ 



1 
k. 


1 l: 


i 


i 


1 


1 Li 


1 


1 *■ 




Y 



J 




X 



-*- ANY.INTERRUPT 

-*- FL — 



EQL- 



-*-NEQ 
■*• < 
-*-GTR 
-*• > 
-•» LSS 
*-GEQ 
■*- LEQ 







SFL- 

SFL- 



--*- CYD 
— »-CYF 

--*"■ CYL 



LSBX- 

LSBY 

LSUX 



-»■ LSUY • 
-*► MSBX • 



LOCKOUT 



—»» HI. PRIORITY - 
-*- INTERRUPT - 
—»■ NO. DEVICE — 



Borrow Out Level 
Carry Flip-Flop 

Carry Out Level 

Least Significant Bit of X 

Lease Significant Bit of Y 
Least Significant Unit of X 
Least Significant Unit of Y 
Most Significant Bit of X 
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Any combination of conditions that is contained in one condition register can be tested using AND/OR 
logic if all bits can be tested for TRUE (on) or FALSE (off). For example, the following are valid 
conditions: 

CYL AND LSUY 
CYL OR CYD 

EXAMPLE: IF CYL AND LSUY TRUE THEN GO TO END.OF. ROUTINE 
IF CYL OR CYD FALSE THEN GO TO LOOP 

If TRUE or FALSE is not specified, TRUE is assumed. 

EXAMPLE : IF TD(2) THEN GO TO LABL7 

Register TD Branch to LABL7 

0101 NO (bit position two is OFF) 

1101 NO (bit position two is OFF) 

0111 YES (bit position two is ON) 

0011 YES (bit position two is ON) 

Note: TD(2) could have been referred to as T(14) 

Example 

The following examples illustrate Format 1 : Conditional Program Control: 

IF X=Y THEN GO TO +A 

IF TB(1) ORTB(3) THEN EXIT 

IF LF(2) THEN 

MOVE X TO Y 
IF FU(1) FALSE THEN 

COMPLEMENT T( 10) 
ELSE 

RESET FL(5) 

FORMAT 2 : CONDITIONAL COMPILATION CONTROL 

This instruction should be used for conditional inclusion of code, depending upon the setting of a user- 
defined, {module.option) toggle. This < module. option) toggle is declared and SET or RESET via a module 
option Scard. (See Appendix A: MIL Compiler Operation.) 

More than one < module.option) toggle can be tested with the same IF statement by using AND/OR logic. 
If NOT is used in front of any < module.option) toggle, that < module.option) toggle is checked for the 
RESET state. If both TRUE and FALSE are omitted, TRUE is assumed. 

NOTES 

1 . A conditional inclusion-block may not be used to 
include or exclude a BEGIN statement when the 
associated END statement is not part of the block. 
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2. Logical operators are valid on the registers 

immediately following the IF, with the following 
restrictions and capabilities: 

a. All registers logically related must be within 
the same 4-bit group: IF T(0) AND T(3) is 
valid, IF T(2) AND T(4) is not. 

b. Only two register elements may be logically 
related: IF T(2) or T(0) is valid, IF T(2) AND 
T(l)ANDT(0)isnot. 

c. NOT logic may be applied anywhere: IF NOT 
( L(3) OR NOT L(0) ) is valid. 

The following examples illustrate Format 1 (Conditional Program Control): 

IF X = Y THEN GO TO +A 
IF TB( 1 ) OR TB(3) THEN EXIT 

IF LF(2) THEN 

MOVE X TO Y 
SETTA(l) 
IF FU(1) FALSE THEN 

COMPLEMENT T( 10) 
ELSE 

RESET FL(5) 
SET L(6) AND L(7) 

IF FLF(3) FALSE THEN 
BEGIN 

RESET FB(1) AND FB(3) 

CLEAR SI 4 A 
END 
XCH S14 F S14 

IF LA(0) THEN 
BEGIN 

MOVE TAS TO T 
END ELSE 

MOVE FA TO T 
MOVE TE TO LF 

IF TD(3) THEN 

MOVE L TO X 
ELSE 
BEGIN 

MOVE T TO X 

MOVE SUM TO X 
END 
MOVE SUM TO FA 



8-44 



IFLA= 14 THEN 
BEGIN 

MOVE 512 TO X 
END 
COMPLEMENT FU(0) AND FU(2) 

The following are examples of conditional inclusion of code : 

$ SET DEBUG, RESET TRACE 
$ SET TRACE, RESET B 1700 

After processing these $ cards, the module options will be set TRUE or FALSE as follows: 

DEBUG = TRUE 
TRACE = TRUE 
B1700 = FALSE 

IF DEBUG THEN INCLUDE 

CALL DEBUG.ROUTINE 
IF TRACE THEN INCLUDE 
BEGIN 

CALL SAVE. REGISTERS 

CALL TRACE. ROUTINE 
END 

IF DEBUG AND NOT B1700 INCLUDE 
BEGIN 

MOVE T TO X 
END ELSE 
BEGIN 

MOVE L TO X 

MOVE T TO SOA 
END 

IF NOT TRACE OR B1700 INCLUDE 
BEGIN 

MOVE L TO X 

MOVETTOS1A 
END ELSE 
BEGIN 

CALL TRACE.ROUTINE 

MOVE T TO X 
END ELSE 
BEGIN 

CALL TRACE.ROUTINE 

MOVE T TO X 
END 

Any of the preceding examples may be nested within any of the above BEGIN/END pairs up to a maximum 
of 1 5 levels. That is, at any given time during a compilation there may be at most 1 5 BEGINs that have 
not been paired with their respective ENDs. 
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INC 

Syntax 



INC 



•(source-sinhregister)- 



BY- 



I 0- 



(source-register) ■ 
(literal) 



J I J 

•J ' +> TEST -*J 



Semantics 

This instruction increments the contents of a 4-bit < source. sink.register) by the value of the < literal) or the 
contents of a 4-bit < source. register). The result is placed in the < source. sink.register); the contents of the 
(source. register); remain unchanged. (See also: DEC.) 



The registers may be any of the following: 
< source.sink.register) 

CA CB *CC *CD 

FT FU 

FLC FLD FLE FLF 

LA LB LC LD LE LF 

TA TB TC TD TE TF 

TOPM (available on B1720 only! 



( source.register) 

( source.sink.register) 

BICN 

FLCN 

INCN (available on B1720 only) 

XYCN 

XYST 



*CC and CD represent processor interrupts and flags 

The literal has a decimal range from to 15. 

If the TEST option is used and source.sink.register overflows (is incremented beyond 15, the largest value 
it can contain), the next micro-instruction is skipped. If overflow does not occur or if the TEST option is 
not used, the next micro-instruction is executed. 

NOTE 

All 4-bit registers count modulo 16; e.g., if a register 
contains a value of 15 and is incremented by 2, it over- 
flows to a value of 1 . 

Example 

INC LB BY 7 

INC FLD BY BICN TEST 
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JUMP 

Syntax 



JUMP 



FORWARD' 



BACKWARD-, 
TO — 



u 



-(literal)- 
- (label) - 



Semantics 

This instruction transfers control to the designated location. 

The address of < label) is limited to a maximum relative displacement of plus or minus 4095 micro- 
instructions. 

The < literal) has a decimal range from to 4095. 

If < literal) is not specified, FORWARD/BACKWARD causes the compiler to generate a JUMP instruction 
with a displacement of zero and a direction sign of plus or minus. This is to facilitate ORing the actual 
displacement into the M register prior to the execution of a JUMP instruction. 

Examples 

JUMP TO + LOOP. 1 

JUMP TO END.OF.CODE.LABEL 

JUMP FORWARD 

JUMP BACKWARD 

NOTE 

It is strongly recommended that only JUMP FORWARD 
and JUMP BACKWARD be used, that they be used only 
without a < literal), and only where necessary to generate 
a displacement of zero. Use the GO TO statement for 
all other uses. 
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LIT 

Syntax 



MOVE 



»- IVIUVt T- 

»- LIT — »J 



(literal) TO 



(sink-register) ■ 



(scratchpad- word) 



u 



Semantics 



This instruction moves a < literal) to any sink (destination) register (except the M register) or to any 24-bit 
scratchpad word. (See also: MOVE.) 

The < literal) may be any decimal integer from to 1 67772 1 5 , a hexadecimal number from @0@ to 
@FFFFF@, a binary number from @( 1 )0@ to @( 1 ) 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 @, or a ( character. string) 
up to three characters in length. Leading zeros are not required unless the actual value of the < literal) is 
zero. The value of the ( literal) should not exceed the maximum value that the < sink.register) can contain; 
if less, left zero fill occurs. 

< Literal) moves to a 24-bit scratchpad word generate MOVE < literal) TO TAS followed by MOVE TAS TO 

< scratchpad, word). 

PROGRAMMING NOTE 

It is recommended that the MOVE instruction be used 
instead of LIT. 



Example 



MOVE 12TOL 





LA 


LB 


LC 


LD 


LE 


LF 




L 


0011 


0000 


1001 


1010 


0001 


0011 


before (309A13) 




-- 


-- 


- 


- 


-- 


1100 


LIT(C) 


L 


0000 


0000 


0000 


0000 


0000 


1100 


after (00000C) 
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LOAD 
Syntax 

LOAD F FROM *-(double.scratchpad'Word)< 



Semantics 

This instruction moves any 48-bit double scratchpad word (SO ... SI 5) to the Field (F) register. 

NOTE 



The compiler will generate two MOVE instructions 
for B 1710 systems. 



Example 

LOAD F FROM SI 1 
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LOAD.MSMA 



Syntax 



(Available on B 1 720 systems only) 



-i — ►» START t- 

' »• STOP — »J 



LOAD.MSMA 1 +> START ■ 

STOP 

Semantics 



This pseudo-operation causes the compiler to either start or stop prefacing all emitted microcode with the 
first 16 bits of a MOVE 24 BIT LITERAL TO MSM A instruction. 

The above action is required when a microprogram is to be loaded into control memory from a cassette 
tape while the system is in the TAPE mode. The action of the hardware while in this mode is as follows: 

.READLOOP 

READ 16 BITS FROM THE CASSETTE TO THE U-REGISTER 

MOVE U TO M 

IF M = FIRST HALF OF 24-BIT LITERAL MOVE, THEN READ 16 BITS 
FROM THE CASSETTE TO U 

EXECUTE THE MICRO-OPERATION IN M 

(IF M= @9D00@=MOVE 24-BIT LITERAL TO THE CONTROL MEMORY 
WORD ADDRESSED BY THE A-REGISTER; THEN U, WHICH NOW 
CONTAINS THE ACTUAL MICRO-INSTRUCTION, IS MOVED TO 
CONTROL MEMORY ADDRESSED BY THE A-REGISTER AND A IS 
INCREMENTED BY 1) 

IF M = CASSETTE STOP THEN 

STOP CASSETTE AND HALT PROCESSOR 

ELSE 

JUMP TO -READLOOP 

No statement between LOAD.MSMA START and its corresponding LOAD.MSMA STOP may reference 
any < label) which has not been declared prior to the LOAD.MSMA STOP. 
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Example 

The following source code could be used to enable a microprogram to be loaded from a cassette into 
control memory, beginning at control memory address zero: 

MOVE TO A 

SEGMENT ANYNAME AT 

LOAD.MSMA START 



(Microprogram) 



LOAD.MSMA STOP 
MOVE TO A 
CASSETTE STOP 
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LOAD.SMEM 
Syntax 

LOAD.SMEM 1 ■- START — r *•{ 

I ►STOP -*J 

Semantics 

This pseudo-instruction causes the compiler to either start or stop appending each micro-instruction with 
the following instructions: 

MOVE 24 BIT LITERAL TO X 
WRITE (25) BITS FROM X 
WRITE 16 BITS FROM X INC FA 

These instructions are required when a microprogram is to be loaded into main memory from a cassette 
tape while the system is in the TAPE mode. 

Example 

MOVE 4096 TO FA % START ADDRESS 

LOAD.SMEM START 

(microprogram) 

LOAD.SMEM STOP 
CASSETTE STOP 

NOTE: The FA must start at a mod 32 value. 
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LOCAL.DEFINES 
Syntax 



LOCAL.DEFINES 



Semantics 

This statement is provided to allow the use of local definitions (see DEFINE, DEFINE.VALUE, DECLARE , 
MACRO). Local definitions are useful in limiting unauthorized or unnecessary access of special-purpose 
definitions outside of their only areas of use. LOCAL.DEFINES, however, does allow duplicate definitions 
with a special local meaning probably different from a more global meaning. Thus microprogrammers should 
be careful to avoid such potentially confusing duplications. 

A definition which follows LOCAL.DEFINES has that definition only within the scope of the block in 
which it is defined. For example: 



BLOCK 




NESTING 




LEVEL 


MIL STATEMENTS 





BEGIN LOCAL.BLOCK.l 


1 


DECLARE L.l FIXED; 


1 


LOCAL.DEFINES 


1 


DECLARE L.2 FIXED; 


1 


BEGIN INNER.BLOCK.l 


2 


DECLARE 1.1 FIXED; 


. 2 


LOCAL.DEFINES 


2 


DECLARE 1.2 FIXED; 


1 


END INNER.BLOCK.l 





END LOCAL.BLOCK.l 





BEGIN LOCAL.BLOCK.2 


1 


DECLARE AA.l FIXED; 



The definition of L.l preceeds LOCAL.DEFINES and may be referenced outside of LOCAL.BLOCK.l. 

The definition of L.2 follows a LOCAL.DEFINES and may be referenced only within LOCAL.BLOCK.l. 

The definition of 1. 1 follows LOCAL.DEFINES of LOCAL.BLOCK. 1 and is within that block. Thus 1. 1 
may be referenced only within LOCAL.BLOCK.l. 

The definition of 1.2 follows LOCAL.DEFINES of INNER.BLOCK.l and is within that block. Thus 1.2 
is limited to use within INNER.BLOCK.l. 

The definition of AA. 1 is not within any block containing LOCAL.DEFINES. Thus AA. 1 may be used 
anywhere in the statements that follow, even outside of LOCAL.BLOCK.2. 
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The previous example was not intended to be a model for microprogrammers. It merely demonstrates the 
effect of LOCAL.DEFINES. Good programming practice is to combine all global definitions at the begin- 
ning of the program and to combine all local definitions after the LOCAL.DEFINES following the BEGIN 
statement of the block to which they are localized. 

Example 

BEGIN LOCAL.BLOCK 
LOCAL.DEFINES 

DEFINE 

DEFINE.VALUE . . . 

DECLARE . . . 

MACRO . . . 

% MIL STATEMENTS FOLLOW 

END LOCAL.BLOCK 



8-54 



MACRO DECLARATION 

Syntax 



MACRO < macro-identifier) 



r — i 

>-► ( -*-*»■{ formal parameter )-l — «». 



: —L^-(statement-list) —I — . — # — w\ 



Semantics 



This declaration assigns a name, the < macro. identifier), to a (statement. list) and declares any (formal. para- 
meters that is used in the (statement. list). Any subsequent reference (see MACRO reference) to (macro, 
identifier) will be replaced in-line by the (statement. list) and any (formal.parameters) used in these state- 
ments will be replaced by the (actual.parameters) used in the MACRO reference. 

The < macro. identifier) and the ( formal.parameter) list must be contained on one line, and this line must be 
terminated by an equal sign (=). The macro statement list must then follow, beginning on the next line, 
with one statement per line. 

A MACRO declaration must be terminated by a pound sign (# ), either at the end of the last statement or 
in columns 6 through 72 of the following line. For this reason, a statement within a MACRO declaration 
must not contain a pound sign that is not a part of a < character. string). 

The (formal.parameter) list must be enclosed in parentheses. A (formal.parameter) must be a (simple, 
identifier). If there is more than one (formal.parameter), they must be separated by commas. 

RESTRICTIONS 

1 . A MACRO must not reference itself although it 
may reference another MACRO. The maximum 
level to which MACROs may be nested is 10. 

2. A MACRO may have a maximum of 7 ( formal, 
parameter)?.. 

3. A MACRO may have a maximum of 100 statement 
lines (records) in its < statement, list). 

4. A MIL program may have a maximum of 1 00 
MACRO declarations. 
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PROGRAMMING NOTE 

A MACRO is often used as a single statement following 
an IF statement. If the MACRO declaration statement 
list consists of more than one statement and the state- 
ment list is not bounded by a BEGIN/END pair, then a 
branch will be made around ONLY the first statement 
when the IF condition tests false. Whenever an entire 
MACRO (statement. list) could conceivably be used as 
either the THEN or ELSE part of an IF statement, the 
first statement in the (statement. list) should be BEGIN 
and the last statement should be END. 



Examples 

MACRO EXCHANGE (DESC. 1 , DESC.2) = 
BEGIN 

LOAD F FROM DESC. 1 
.LOOP 

SWAP.THE.F.FIELD.WITH (DESC.2) 
IF FL NEQ THEN GO TO -LOOP 
END# 

MACRO SWAP.THE.F.FIELD.WITH (FIELD) = 
BEGIN 

BIAS BY F 
READ TO X 
XCH FIELD F FIELD 
SWAP WITH X 

COUNT FA UP AND FL DOWN BY CPL 
XCH FIELD F FIELD 
WRITE FROM X INC FA AND DEC FL 
END* 

% The above MACROs could be referenced as follows: 

IFX YTHEN 

EXCHANGE (FIELD.A, FIELD.B) 
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MACRO REFERENCE 

Syntax 



< macro-identifier) ■ 



rz 1 

-» — ^{actual-parameter)-*— »■ ) 



Semantics 

A MACRO reference is replaced in-line by the statements in the < statement, list) associated with the 
MACRO declaration of < macro.identifier) and the < actual.parameter)* replace the occurrences of {formal, 
parameter)* used in these statements (see MACRO declaration). 

There must be a one-to-one correspondence between formal and actual parameters, i.e., no {actual.para- 
meter) may be omitted or left empty (blank), and the first { actual.parameter) replaces the first formal, 
parameter declared, etc. 

{Actual.parameter)* may be < identifier), { literal)*, < string)*, reserved words, single line MIL statements or 
portions of statements. In short, they may be almost anything, with the following exceptions: 

RESTRICTIONS 

{Actual.parameter)* may not be or contain: 

1 . A comma, %, or unpaired parenthesis, unless con- 
tained in a ( character, string). 

2. An unpaired quotation mark (")• 

3. A < label), unless preceeded, as a part of the 
{actual.parameter), by a non-label token. 

Example 

MACRO GET.TABLE.DATA (TABLE.ADDRESS,ELEMENT.LENGTH, ELEMENT.IX, REG) = 
BEGIN 

MOVE ELEMENT. LENGTH TO X 

MOVE ELEMENT.IX TO Y 

CALL SET.SCRATCH.TO.X.TIMES.Y 

MOVE TABLE.ADDRESS TO FA 

ADD INTERP.MAIN.MEMORY.BASE TO FA 

ADD SCRATCH TO FA 

READ ELEMENT. LENGTH BITS TO REG 
END# 
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% Which could be referenced as: 

GET.TABLE.DATA (ADDRESS (TABLE.A), 24, L, X) 

Note that TABLE.A is a < label) and therefore could not be used alone as an {actual parameter) . 
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MAKE. SEGMENT.TABLE.ENTRY 

Syntax 



MAKE.SEGMENT.TABLE.ENTRY 



Semantics 



' *- VALUE (literal) -»J 



This instruction causes an entry to be written into the segment name-to-number correspondence table 
which is made a part of the final code file. This table, together with the segment dictionaries, can be used 
for load time binding. 

The format of each entry in the correspondence table is as follows: 

1 CORRESPONDENCE.TABLE.ENTRY BIT (44) 

2 CORR.SEGMENT.NAME CHARACTER (10), 

2 CORR.EXTERNAL.SEGMENT.NUMBER BIT (8), 

2 CORR.INTERNAL.SEGMENT.NUMBER BIT (8), 

2 CORR.VALUE BIT (8), 

2 CORR.INTERNAL.SEGMENT.FLAG BIT(l), 

2 FILLER BIT (39); 

CORR.VALUE is set to zero if the "VALUE < literal)" clause is not present. If present, it must not exceed 
255. 

CORR.ESTERNAL.SEGMENT.NUMBER is always set to the number of the current external (CODE. 
SEGMENT) segment. If no CODE. SEGMENT statement has been compiled at a given point, the value is 
zero. 

If this statement is used immediately following a SEGMENT statement then the remaining fields are set 
as follows : 

CORR.SEGMENT.NAME is set to the name of the internal segment with right truncation or 
blank fill. 

CORR.INTERNAL.SEGMENT.NUMBER is set to the number of the internal segment. 
CORR.INTERNAL.SEGMENT.FLAG is set to 1. 

If this statement is used immediately following a CODE.SEGMENT statement, or prior to the occurrence 
of either any CODE.SEGMENT or SEGMENT statement then the remaining fields are set as follows: 

CORR.SEGMENT.NAME is set to the name of the external (CODE.SEGMENT) segment, with right 
truncation or blank fill. This field will be blank if neither a CODE.SEGMENT nor a SEGMENT 
statement has yet occurred. 
CORR.INTERNAL.SEGMENT.NUMBER is set to zero, as is CORR.INTERNAL.SEGMENT.FLAG. 

This statement can be used more than once within a segment if more than an 8-bit value is required. 
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MICRO 

Syntax 



MICRO 



-(literal) ■ 



Semantics 

This instruction places a 16-bit constant in line. The programmer is responsible for providing any protec- 
tion that may be needed to prevent a MICRO from executing; therefore, this instruction should be used 
with caution. 

The < literal) has a decimal range from to 65535. 

Examples 



MICRO @83AA@ 
MICRO "22" 
MICRO "HI" 
MICRO 784 



% THIS IS EQUIVALENT TO "MOVE @AA@ TO L" 

% THIS IS EQUIVALENT TO @F2F2@ 

% "HI" = @C8C9@ 

% = @0310@ = "CLEAR X" 
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M.MEMORY.BOUNDARY 

(Available on B 1720 systems only) 
Syntax 

M.MEMORY.BOUNDARY — i ► MINIMUM 



I ► MINIMUM — j W 

I *► MAXIMUM -»J 



Semantics 



This instruction sets the M.MEMORY boundary fields within the IPB (Interpreter Parameter Block) of a 
MIL program to the current code address. 

MINIMUM specifies to the operating system the number of micro-instructions that must be loaded into 
M-Memory before the micro-program may be given control. If, however, this value exceeds the amount 
of M-Memory physically present on a given system, the value will be ignored (considered = 0). The state- 
ment is generally used to ensure that the most used microcode will execute from control memory, where 
it executes faster than if it is executed from main memory. 

MAXIMUM specifies the maximum M-Memory utilization of a micro-program. No code emitted after the 
occurrence of this statement will ever be loaded into, and hence executed from, M-Memory. It is generally 
used to keep non-executable data, such as TABLEs, from being loaded into control memory, thus being 
made inaccessible in main memory. 

Thus at all times the portion of microcode in M-Memory will be, at the discretion of the operating system, 
from the beginning of a given microprogram until some point between the appearance of the M.MEMORY. 
BOUNDARY MINIMUM and the M.MEMORY.BOUNDARY MAXIMUM statements. The fields are 
ignored for stand-alone microprograms. 
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MONITOR 

Syntax 

MONITOR -^{literal)- 



Semantics 

This instruction emits the monitor micro-operator with the < literal) occurrence identifier. (See also 
Appendix B: MONITOR.) 

The < literati has a decimal range from to 255. 

Example 

MONITOR 5 
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MOVE 

Syntax 



MOVE 



'(source-register ) — 
-(scratchpad-word) ■ 



ADDRESS (label-reference)' 



■+* H -/^arithmetic expression)^ 



-^ 4* i*\ 



-(arithmetic expression) - 
►SEGMENT.COUNT — 



• HEX.SEQUENCE.NUMBER 
■CODE.SEGMENT.NUMBER 



' T0 C 



(source- sink-register 
(scratchpad- word) 



'JT 1 



Semantics 

This instruction copies the specified information into a (source.sink.register) or scratchpad word. 

ADDRESS (< label. reference)) is a literal value equal to the code address of the label reference. 

SEGMENT.COUNT is a literal value equal to the number of times a Segment statement has occurred. 

HEX.SEQUENCE.NUMBER is a literal value equal to the leftmost six digits of the current source state- 
ment sequence number. 

CODE.SEGMENT.NUMBER is a literal value equal to the current CODE.SEGMENT number. 

The following are restrictions on an S-Memory Processor. 

a. If ADDRESS or < arith. expression) has a value greater than 255, and < soarce.sink.register) is 
CP, the move wll not take place. 

b. If (source. register) is U, (source. sin k. register) may not be TAS, M, or A. 

c. If < source, register) is A, CP, M, or DATA, < source.sink.register) may not be a 4-bit register. 

d. If ( source. register) is SUM or DIFF, < source.sink.register) may not be CMND or DATA. 
The following are restrictions on both an S-Memory and M-Memory Processor. 

a. When < source. register) is DATA, < source.sink.register) may not be DATA or CMND. 

b. When (source.sink.register) is M, the operation is changed to a BIT-OR which modifies the 
next micro-operation; it does not modify the instructions stored in memory. In tape mode 
no BIT-OR takes place. A literal value generated from ADDRESS, (arith. expression), or 
SEGMENT.COUNT may not be moved to the M register. 
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Examples 

MOVE X TO Y 

MOVE 48 TO SI A 

MOVE ADDRESS (+ GLOP) TO T 

MOVE 10TOTA 

MOVES12ATOS10B 

MOVE ADDRESS (BLAH) +16 * 8 - 1 TO FA 

MOVE SEGMENT.COUNT TO T 

MOVE (81+(3*10)-1 )/2 TO Y 
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NOP 

Syntax 



NOP 



Semantics 

This NO OPERATION instruction does nothing except use one clock cycle and take up one word of 
control or main memory. 



8-65 



NORMALIZE 
Syntax 



NORMALIZE 



Semantics 

This instruction shifts the contents of the X register left while counting the FL register down until 
either the most-significant bit of X (determined by CPL) equals 1 or FL equals 0. If the most-significant 
bit of X is already 1 , of if FL is already 0, then no shift takes place. 
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OR 

Syntax 



OR 



■ (source-sinhregister) • 



■♦•WITH 



n 



(source-register)- 
(literal) 



J 



Semantics 

This instruction is used to logically OR the contents of the 4-bit < source. sink.register) with the value of 
the < literal) or the contents of a 4-bit ( source. register). The result is placed in < source. sink.register); 
the contents of (source. register) remain unchanged. (See also: AND and EOR.) 



The < registers may be any of the following: 

< source. sink.register) 

CA CB *CC *CD 

FT FU 

FLC FLD FLE FLF 

LA LB LC LD LE LF 

TA TB TC TD TE TF 

TOPM (available on B1720 only) 



< source, register) 

( source, sin k. register) 

BICN 

FLCN 

INCN (available on B1720 only) 

PERR (available on B1720 only) 

XYCN 

XYST 



*CC and CD represent processor interrupts and flags 
The < literal) has a decimal range from to 15. 

TABLE 8-3 OR Truth Table 



Source. Sink .Register 


( literal) 
( Source. Register) 


< Source.Sink.Register) 





OR 





Yields 





1 


OR 





Yields 


1 





OR 


1 


Yields 


i 


1 


OR 


1 


Yields 


1 
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Example 



OR TB WITH 3 





TA 


TB 


TC 


TD 


TE 


TF 




T 


0000 


0101 


1111 


0011 


0001 


0010 


before (05F312) 




-- 


0011 


-- 


-■ 


■■ 


- 


literal (3) 


T 


0000 


0111 


1111 


0011 


0001 


0010 


after (07F312) 
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OVERLAY 



Syntax 



(Available on B 1720 systems only) 



OVERLAY 



Semantics 



This instruction overlays control memory from main memory. Before an overlay is initiated the L register 
must contain the first control memory overlay address, the FA register must contain the beginning main 
memory address, and the FL register must contain the length in bits to be overlay ed. Overlay will continue 
until the FL register equals or the A register is out of bounds. If the A register goes out of bounds, FA 
contains the address of the next micro-instruction in main memory; FL contains the length in bits of 
unfetched data. 

The action of the hardware executing this instruction is as follows: 

MOVE A TO TAS 
MOVE L TO A 
.LOOP 

READ 16 BITS TO L INC FA AND DEC FL 

MOVE L TO CONTROL MEMORY ADDRESSED BY A 

INC A 

IF FL NEQ AND A NOT OUT OF BOUNDS THEN GO TO -LOOP 
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PAGE 
Syntax 

PAGE J 

Semantics 

This instruction causes the source listing to skip to the top of a new page at compile time. Code is not 
generated. 
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POINT 

Syntax 



POINT FA TO P" (arithmetic-expression) *\ 



Semantics 

This pseudo-operation causes the compiler to generate an instruction that adjusts the value of FA to the 
value of the (arithmetic, expression). 

Prior to the execution of this instruction, the compiler must have been given some knowledge of the 
contents of FA. This can be done via: 

MOVE ( arithmetic. expression) TO FA 

or 

FA.POINTS TO ( arithmetic, expression) 

FA will be adjusted by up to 144 bits as a result of this command. (A warning message will result if the 
adjustment is greater than 72 bits). (See also: READ and WRITE.) 

Example 

DECLARE 

01 STRUCTURE, 

02 DATA.ABIT(10), 

02 DATA.B CHARACTER(20), 

02 DATA.C FIXED; 

FA.POINTS TO DATA.A 

READ DATA. LENGTH (DATA.A) BITS TO X POINT FA TO DATA.B 

POINT FA TO STRUCTURE 

MOVE DATA.C TO FA 

WRITE DATA.LENGTH (DATA.C) BITS FROM Y POINT FA TO DATA.B 
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PROGRAM. LEVEL 

Syntax 



-«, CAT 

EL -L 



PROGRAM. LEVEL - 1 — i — *- (character-string) 

"-TODAYS. 



DATE -»J 
TIME -*J 



■TODAYS. 



Semantics 

This instruction places forty characters of information into the PROGRAM. LEVEL location of the IPB 
(Interpreter Parameter Block). 

If the TITLE statement is unused, the title headings of the program listing will reflect the PROGRAM. 
LEVEL information. 

Example 

PROGRAM.LEVEL "THIS IS A SUBHEADING " CAT TODAYS.TIME 
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READ 
Syntax 



READ 



MSML TO X 



(literal) 



~C 



BIT - 
BITS 



• •— »► REVERSE -W 



TO' 



INC 



FA 
FL 



DEC 



FA AND DECFL 

FLAND DEC FA 

FA 

FL 



FA AND FL 
FLAND FA 



*► FA AND INCFL 

*► FLAND INC FA 

+~ FA AND DECFL i 

*■ FLAND DEC FA 1 

POINT FA TO {arithmetic-expression) 



X 
Y 

T 
L 



n ii 



Semantics 

An M-Memory READ MSML TO X instruction reads to the X register the 16 bits in M-Memory pointed to 
by the contents of the L register. The contents of L must be modulo 1 6. This facility is not available on 
S-Memory Processors. 

An S-Memory READ instruction reads from to 24 bits of information from S-Memory into one of the 
allowable sink (destination) registers: X, Y, T, or L. 

If the < literal) is zero or is not specified, the field length is given by the contents of CPL. The read data 
will be right justified in the selected sink register. If the field length is zero then X, Y, T, or L will be set 
to zero. 

Normally, on an S-Memory read, the contents of the FA register point to the first bit of the field to be 
read. If the REVERSE option is used, the contents of the FA register point to the last bit + 1 of the field 
to be read. The sink register receives the contents of this field as if it has been read in a forward direction. 
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INC/DEC adjusts FA/FL by the field length after the operation but in the same micro-instruction. 

POINT FA adjusts FA by up to 144 + field length bits after the operation. (A warning message will be 
issued if the adjustment is greater than 72 + field length bits). The POINT FA option can be used only 
if < literal) BIT(S) is specified and is greater than 0. (See also: FA.POINTS and POINT.) 

Examples 

READ MSML TO X 

READ 24 BITS TO X 

READ TO Y INC FA 

READ 2 BITS REVERSE TO T DEC FA AND FL 

READ REVERSE TO L INC FL 

READ 10 BITS TO T POINT FA TO 100 
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REDUNDANT.CODE 
Syntax 

REDUNDANT.CODE — , — »» START 



— I — ^ START — j- 
' — »► STOP — J 



Semantics 



This REDUNDANT.CODE START pseudo-instruction causes the compiler to emit each micro twice until 
the occurrence of the REDUNDANT.CODE STOP pseudo-instruction. It can be used to help ensure the 
correct loading of a program or data from cassette. 
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RESERVE. SPACE 

Syntax 

RESERVE.SPACE FOR ^-{arithmetic- expression) •*■ BITS 1 

Semantics 

This instruction causes the compiler to emit a sufficient number of NOP's (@0000@) to allow for the 
number of bits specified by < arithmetic, expression). 

The actual amount of space reserved will always be MOD 16; therefore up to 15 bits more than that 
specified by the < arithmetic. expression) may be reserved. 

Example 

DECLARE IO.DESCRIPTOR BIT(188); 

DESC.LOCN 

RESERVE.SPACE FOR DATA.LENGTH(IO.DESCRIPTOR) BITS 
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RESET 

Syntax 



RESET 



U»- NOT — *J 



■^■(register) ({literal)) 



1 T ^ AND 



C — IT 

•— *► NOT -»J 



register)((literal)) 



Semantics 

This instruction RESETs (sets to zero) the bit specified by the < literal) into the register. By using the 
options, more than one bit in any one register can be reset with the same instruction IF ALL BITS ARE 
IN THE SAME 4-BIT REGISTER. (See also: COMPLEMENT and SET.) 

The register may be any 4-bit source and sink (destination) register below: 

CA CB CC CD (CC and CD represent processor interrupts and flags) 

FT FU 

FLC FLD FLE FLF 

LA LB LC LD LE LF 

TA TB TC TD TE TF 

TOPM (available on B 1720 only) 

It may also be the FL, FB, L, or T register : all bits must then be in the same 4-bit subfield. 

The < literal) has a decimal range from to 3 for a 4-bit register; from to 1 5 for the FL register; and 
from to 23 for the FB, L, and T registers. 



Example 



RESET T(0) AND TA(3) 



TA 



TB 



TC 



TD 



TE 



TF 



1111 



1010 



1100 



1110 



1001 



1001 



before (FACE99) 



0110 



■4-4- 



1010 



1100 



1001 



1001 



after (6ACE99) 




T(0)' 



3 4 
»- TA(3) 



7 8 



11 



15 16 



17 18 



23 
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ROTATE 
Syntax 

ROTATE • 



T 



LEFT BY 



IT 



-{literal) BITS- 



CPL - 
IGHTBY<«tera/> BITS - 
LEFT r-** BY 



c 



TO {register)- 



x "nt^ 1 ~j 

Y -«H ^ RIGHT -*J 



<ftYera/> BITS' 



XY 



Semantics 

See SHIFT/ROTATE T and SHIFT/ROTATE X/Y/XY 
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SEGMENT 
Syntax 

SEGMENT - 



*- NEWSEGMENT 
{label) 



TTT 



AT 



-ADDRESS {{label))- 
• < literal) 



J 



J 



NOTE: The {literal) must be MOD 16. 



Semantics 

See: Section 5 (SEGMENTATION). 
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SET 
Syntax 



SET 



L»- NOT -*-> 



(register) TO (literal ) - 
► < register > ( (literal)) - 



L£ 



AND 



c — U* 

•-*■ NOT -» J 



•{register) « Jtf era/> ) 



a 



Semantics 

This instruction SETs the < register) to the value of the < literal) or SETs (bit=one) the bit specified by the 
< literal) into the (register). By using the options more than one bit in any one register can be set with the 
same instruction IF ALL BITS ARE IN THE SAME 4-BIT REGISTER. (See also: COMPLEMENT and 
RESET.) 

SET < register) TO < literal): The < register) may by any 4-bit source and sink (destination) register listed 
below. 

CA CB CC CD (CC and CD represent processor interrupts and flags) 

FT FU 

FLC FLD FLE FLF 

LA LB LC LD LE LF 

TA TB TC TD TE TF 

TOPM (available on B 1720 systems only) 

It may also be the CPU register. If CPU is used, the < literal) has a decimal range from to 3; otherwise 
the < literal) has a range from to 15. 

SET < register) (< literal)): The < register) may be any 4-bit source and sink register listed above. It may be 
theFL, FB, L, or T register: all bits must then be in the same 4-bit sub field. The < literal) has a decimal 
range from to 3 for a 4-bit register; from to 15 for the FL register; and from to 23 for the FB, L, and 
T registers. 



Examples 



SET TA TO 3 





TA 


TB 


TC 


TD 


TE 


TF 






T 


1111 


0100 


0101 


0110 


0111 


1000 


before (F45678) 


T 


0011 


0100 


0101 


0110 


0111 


1000 


after (345678) 
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SETTC(2)ANDT(11) 





TA 


TB 


TC 


TD 


TE 


TF 




T 


0001 


0010 


0000 


0100 


0101 


0110 


before (120456) 


T 


1001 


0010 


0011 


0100 


0101 


0110 


after (923456) 



TC(2) • 
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SHIFT/ROTATE T 



Syntax 



SHI 



I FT T -!-► LEFT BY — r-*- (literal) BITS 



I 



r 



CPL 



IGHTBY<tffera/>BITS 



ROTATE T 






LEFT BY -r*-</jrera/>BITS 
CPL 



•-•-RIGHT BY (literal) BITS 




Semantics 

This instruction SHIFTs or ROTATEs the contents of the T register and places the result either in T or in 
some other source and sink (destination) register. If the result is not placed in the T register, T remains 
unchanged. SHIFT will zero fill. 

The < literal) has a decimal range from to 24. 

SHIFT/ROTATE T LEFT: If or CPL is used, a shift or rotation by the value of the CPL register will 
occur. If CPL is greater than 24, 24 is used. 

TO < register): places the shifted or rotated results in the specified source and sink register; the T register 
remains unchanged. If the TO register option is not used, the result is placed in the T register. The register 
may be any source and sink register except DATA or MBR (refer to: Registers and Scratchpad). If the 
< register) is M, the result of the SHIFT/ROTATE operation is BIT-ORed into the M register and modifies 
the next micro-instruction. 

ROTATE T RIGHT: Because the hardware can only rotate the T register to the left, the compiler converts 
this instruction to the proper left rotate to accomplish the same result as the rotate right. 

SHIFT T RIGHT: Because the hardware can only shift the T register left, the compiler will generate an 
EXTRACT to accomplish the same result. Therefore, the T register may be shifted right only to the X, 
Y, T or L register. If the TO... option is not used, the result is placed in the T register; otherwise, the T 
register remains unchanged. 



PROGRAMMING NOTE 

It is recommended that the EXTRACT instruction 
be used rather than SHIFT T RIGHT. 
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Examples 



ROTATE T LEFT BY 4 BITS 





TA 


TB 


TC 


TD 


TE 


TF 




T 


0110 


0011- 


1000 


0101 


1111 


0000 


before (6385F0) 


T 


0011 


1000 


0101 


1111 


0000 


0110 


after (385F06) 



SHIFT T LEFT BY 4 BITS 





TA 


TB 


TC 


TD 


TE 


TF 




T 


0110 


0011 


1000 


0101 


1111 


0000 


before (6385F0) 


T 


0011 


1000 


0101 


1111 


0000 


0000 


after (385FO0) 
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SHIFT/ROTATE X/Y/YX 
Syntax 



r-*- SHIFT 1 — !-*► X i | »» LEFT v 

"— ^ ROTATE — »J -»> Y — »» •-»- RIGHT — ** 



LEFT 1-»- BY ^-(literal) BITS 



XY 



Semantics 

This instruction shifts or rotates the X, Y, or XY register (X concatenated with Y) a specified number of 
bits to the right or left. Zero fill will; occur with the SHIFT instruction. 

The < literal) has a decimal range from to 23 for the X and Y register; and from to 47 for the XY 
register. 

NOTE 

The < literal) has a maximum value of 1 on the B 1710 
systems when the concatenated XY register is specified. 

Example 

SHIFT X LEFT BY 5 BITS 
ROTATE XY RIGHT BY 40 BITS 
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SKIP 

Syntax 



SKIP WHEN 



•(register) 



ALL- 

ANY 
EQL 



L-»- CLEAR —tJ 



'(literal) 



-(condition) 



' — *» FALSE -*J 



Semantics 

This instruction causes one micro-instruction to be skipped if the designated < condition) is satisfied. (See 
also: IF.) 

SKIP WHEN < registers): The < literal) contains a 4-bit mask and may be comprised of decimal, binary, or 
hexadecimal entries. ' 

ALL is considered to be true only if all the bits in the < register) corresponding to one bits in the mask are 
true. That is, only the designated bit positions are tested to see if they contain ones. ANY is true if at 
least one bit in the < register) corresponding to a one bit in mask is true. EQL is true if all the < register) 
bits equal the corresponding bits in the mask. That is, the ( register) must be exactly like the mask. 

ALL CLEAR causes the masked bits of the < register) to be set to zeros after testing the ALL condition. 
Only the bits tested are cleared, and the clearing action always occurs whether the SKIP is taken or not. 
If ALL is used with a mask of 0000, the result is always false. 

FALSE causes a skip when the whole < condition) is false. 

SKIP WHEN condition: The < condition) may be any condition available from the condition registers. 
(See: IF.) 

The register may be declared as follows: 



FU 


TA 


LA 


CA 


BICN 


FT 


TB 


LB 


CB 


FLCN 


FLC 


TC 


LC 


CC 


INCN 


FLD 


TD 


LD 


CD 


XYCN 


FLE 

FLF 


TE 
TF 


LE 

LF 




XYST 
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PROGRAM NOTE 

The use of the IF.. .THEN.. .ELSE instruction is recom- 
mended rather than the SKIP instruction. The SKIP is 
limited to one, 4-bit grouping mask in one register and 
may only skip one micro -instruction. The IF is capable 
of testing any combination of bits in many registers or 
skipping blocks of micro- instructions and will generate 
a SKIP WHEN hardware micro-instruction whenever 
possible. 
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S.MEMORY.LOAD 
Syntax 

S.MEMORY.LOAD *» START 



Semantics 

This instruction specifies the location for beginning statements in S.MEMORY. Code is not generated, but 
the code address of the last statement is placed in the IPB (Interpreter Parameter Block) at RESERVED. 
M.MEMORY. 

This statement is used to specify the size of all code emitted previous to its occurrence into IPB. 
RESERVED.M.MEMORY in the Interpreter Parameter Block of the final code file. IPB.RESERVED.M. 
MEMORY can then be used by a load time binder to load previously-generated code into control memory 
and to make allowances for its absence in main memory. 
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STORE 
Syntax 

STORE F INTO +» (double- scratchpad-word) M 

Semantics 

This instruction MOVEs the Field (F) register into any double scratchpad word (SO . . . SI 5); the F 
register remains unchanged. 

NOTE 

The compiler generates two MOVE instructions on 
B 1710 systems. 

Example 

STORE F INTO S6 
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SUB. TITLE 
Syntax 



SUBTITLE 



CAT 

- {character-string) 

• TODAYS.DATE 
-TODAYS.TIME- 



Semantics 

This instruction modifies program title information. 

If {character. string) exceeds 72 characters, right-hand truncation will occur. 

$ HEADINGS and $ PAGE.NUMBERS must be specified if subtitles are to be listed on page headings. 

Example 

SUBTITLE TODAYS.DATE CAT "PROB.A" CAT TODAYS.TIME 
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SUBTRACT SCRATCHPAD 
Syntax 

SUBTRACT ^-{scratchpad-word) ■*■ FROM FA *\ 

Semantics 

This instruction subtracts the left half of any scratchpad word (SOA . . .S15A) from the Field Address 
(FA) register. The result is placed in FA; the contents of {scratchpad. word) remain unchanged. (See 
also: ADD SCRATCHPAD.) 

Example 

SUBTRACT S3A FROM FA 
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SWAP 
Syntax 



SWAP (literal) BITS 



u 



REVERSE 



~J 



WITH 



L 
T 
X 
Y 



Semantics 

This instruction swaps the specified number of bits between main memory and the specified register. 

The FA (Field Address) register must have been previously set to the proper main memory address. 

The < literal) has a decimal range from to 24. If the value of < literal) is zero, the contents of the CPL 
register are used. If the CPL register is also 0, the register is cleared to all zeros. If less than 24 bits are 
swapped, the leading bits of the register are set to zero. 

Normally the contents of the FA register point to the first bit of the field to be swapped. If the REVERSE 
option is used, the contents of FA point to the last bit + 1 of the main memory field involved. The 
specified register (L, T, X or Y) receives the contents of this field as if it has been read in a forward 
direction. 

For the B 1710 (SSubset specified) the compiler emits the following code: 

MOVE T TO TAS 

READ (literal) BITS (REVERSE) TO T 

WRITE (literal) BITS (REVERSE) FROM (register) 

MOVE T TO (register) 

MOVE TAS TO T 

PROGRAMMING NOTE 

Incrementing or decrementing of the FA or FL registers 
is not allowed with the SWAP instruction. 
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TABLE 
Syntax 



TABLE (label) 



BEGIN — I — -i— *- (character-string) 
\ — »- (hex- string) 



END 



Semantics 

This instruction creates in-line character strings. 

Any number of strings are allowed per line, but a string cannot cross a line boundary. The<hex.string>must 
be enclosed within @ signs. 

The BEGIN/END pair must surround all strings in the TABLE. The characters are grouped two per 
address, i.e., 16 bits. 

The < label) of the table must be unique; its use references the first 1 6 bits of the table. 
Example 



TABLE REF 
BEGIN 

"AB" 

@ABC@ 

"D" 

"45" 
END 
MOVE ADDRESS (REF) TO Y 



Code generated : 

C1C2 
C1C2 

C3C4 
F4F5 

The address of the table (REF) will 
be loaded into the Y register 
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TITLE 
Syntax 



TITLE 



CAT -*— 

. {character-string) ■ 
■ TODAYS.DATE - 
-TODAYS-TIME - 



Semantics 

This instruction modifies program title information. 

If < character. string) exceeds 72 characters, right-hand truncation will occur. 

$ HEADINGS and $ PAGE. NUMBERS must be specified if titles are required on following pages. 

Example 

TITLE TODAYS.DATE CAT "PATCHES" 
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TRANSFER.CONTROL 

Syntax 



TRANSFER.CONTROL 



Semantics 



This instruction generates the Transfer.Control micro-instruction. (See Appendix B: Transfer.Control). 
On the B 17 10 series it acts as a NOP. 

When it is necessary to transfer control from one firmware process to another, the A, MBR, and TOPM 
registers may all need to be changed. Changing any one of these registers will cause a transfer of control 
to some micro other than the next micro in line. Consequently some means of changing all three of these 
registers simultaneously is required; this will be accomplished with the Transfer.Control instruction. 

The action of the B 1 720 hardware is as follows: 

MOVE L TO MBR 

MOVE TF TO TOPM 

MOVE T(6) THRU T(19) TO A 

Example 

MOVE ADDRESS.OF.GISMO.IN.S.MEMORYTO L 

MOVE GISMO.EVENT. ADDRESS TO T 

MOVE TO TF 

TRANSFER.CONTROL % OFF WE GO . . . 
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WRITE 
Syntax 



WRITE 





MSML FROM X 








T— «• 


-** (literal) ■ 

-^((literal)) — »■ 




r-»-FROM - 

—►REVERSE — »J 


r*- x — i — | 

n 


— *• 




1 Ll CIT "J " 

1 — »- BITS — »J 








-*~ L -*» 










■*- IMP 


>» n 












i 


i 


^ 








* 1 L ^ 

-*> FA AND DEC FL — •« 










—ah- DEC 1 


L-»- FLAND DEC FA -*J 
fc- FA 












i 

-»► FL •» 


i 










-*- FA AND FL ►> 

-»- FLAND FA »■ 

— •»> FA AND INCFL --*- 












-*- FLAND INC FA —»- 












-^- FA AND DEC FL -*- 












— »- FL AND DEC FA — ^ 










—•►•POINT FA 


TO (arithmetic- expression) 




^ 





Semantics 

An M-Memory WRITE (MSML TO X) instruction writes from the X register the 1 6 bits in M-Memory 
pointed to by the contents of the L register. The contents of L must be modulo 16. This facility is not 
available on S-Memory Processors. 

An S-Memory WRITE instruction writes from to 24 bits of information into S-Memory from one of the 
allowable source registers: X, Y, T, or L. 

The amount of data written (field length) is determined by the < literal)/(( literal)) BIT(S) option. If this 
is equal to or is empty, then the field length is given by the contents of CPL is right justified in the 
selected source register. If the field length is zero then nothing is written. 
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Normally the contents of the FA register point to the first bit of the field to be written. If the REVERSE 
option is used, the contents of the FA register point to the last bit + 1 of the field to be written to memory. 
Memory contains the rightmost contents of the source register as if it had been written in a forward direc- 
tion. 

INC/DEC adjusts FA/FL by the field length after the operation but in the same micro-instruction. 

POINT FA adjusts FA by up to 144 + field length bits after the operation. (A warning message will be 
issued if the adjustment is greater than 72 + field length bits). This option can be used only if < literal)! 
« literal)) BIT(S) is specified and is greater than 0. (See also: FA.POINTS and POINT.) 

The unparenthesized < literal) has a decimal range from to 24. « Literal)) has a decimal range from to 
26: a value of 25 will cause 24 bits to be written with correct parity; a value of 26 will cause 24 bits to be 
written with incorrect parity. 

Examples 

WRITE MSML FROM X 

WRITE 24 BITS FROM X 

WRITE FROM Y INC FA 

WRITE 2 BITS REVERSE FROM T DEC FA AND DEC FL 

WRITE REVERSE FROM L DEC FL 

WRITE 10 BITS FROM T POINT FA TO 25 
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WRITE.STRING 
Syntax 



WRITE.STRING 



■(string) 



INC 



DEC 



REVERSE 



1-»- FROM !-*► X 



FA AND FL 
FL AND FA 



FA AND INC FL — 

FL AND INC FA — H 

FA AND DEC FL — 

FL AND DEC FA — 



X 

Y 

T 
L 




Semantics 

This instruction generates the necessary in-line < literals for a ( string), with moves to the indicated register. 
It also generates the WRITE commands to write the < string) into main memory, beginning at the address 
in the FA register. If < literal) exceeds 24 bits, then an INC or DEC on FA is required. 

The length of the < string) is limited to the remainder of the source card image. It may be any of the data 
types shown in table 8-4. 

Table 8-4. String Definitions 



Example 

"APC128JKL" 

@124ADF@ 
@(3)123567@ 
@(2)123321@ 
@(1)11001101@ 



Data 


Start-Stop 


Length of 


Type 


Symbol 


Each Unit 


Character 


- 


8 bits 


Hex 


@ 


4 bits 


Octal 


@(3) 


3 bits 


Quartal 


@(2) 


2 bits 


Unary 


@(D 


1 bit 
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Examples 

WRITE. STRING "APC" REVERSE FROM X 

WRITE.STRING "THIS PUTS A LITERAL INTO MEMORY" FROM T INC FA 



8-98 



XCH 
Syntax 



XCH +~ (double-scratchpad-word. 1) »► F *► (double-scratchpad-word.2) +\ 



Semantics 

This instruction moves the Field (F) register to double scratchpad word.2 (SO . . . SI 5); double scratchpad 
word . 1 (SO ... S 1 5 ) is then moved to the F register. The two words may be the same , causing data to be 
swapped between F and a double scratchpad word. 

Example 

XCH SO F SO % equivalent to: MOVE FA TO SO A 

% MOVE FL TO SOB 

% 

% and simultaneously: MOVE SOA to FA 

% MOVE SOB TO FL 
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9 PROGRAMMING TECHNIQUES 



VIRTUAL-LANGUAGE DEFINITIONS 

A set of virtual-instructions for the virtual machine must first be defined as each being a unique string of 
bits. This definition may be chosen according to any relevant criteria. For example, COBOL verbs may 
be encoded according to their frequency of usage, the higher frequency verbs being encoded in three bits 
with one escape code that specifies the next eight bits as an extended code string. Another approach 
might be to accept directly the source language as in a time-sharing, "Line-at-a-time," interactive mode. 
After the S-instructions and their operand fields have been defined, any standard location or technique 
should be selected. For example, the base values of S-instructions and S-data might be in S4A and S5A 
of the scratchpad; or all routines are to be referenced with CALL and end with an EXIT instruction to 
facilitate subroutine usage. The microprogrammer is now ready to begin creating the microroutines needed 
to perform each of the events in the S-language. 

SOURCE IMAGE FORMAT 

The compiler accepts card images consisting of one symbolic micro-instruction per card. The source pro- 
gram must reflect the following format: 

Column Usage 

1 -5 Reserved for < label) declarations which, if used, must begin somewhere within 

this field. Both < point. labeDs and (unique. labeDs are allowed, with a limit of 63 
characters and no embedded blanks. A blank is the separator between the label 
and the beginning of the micro-instruction. < Unique. labeDs must be unique with- 
in the first 23 characters; the remainder is considered documentation. (Point. labeDs 
must be unique within the first 25 characters. 

1-72 A percent sign (%) anywhere within this field indicates that the remainder of 

the card image is to be ignored. 

6-72 MIL statements may appear anywhere within this field. At least one blank must 

be used between words except in those cases where a (special. character) (e.g., 
a parenthesis or relational operator) is used, in which case blanks are 
optional. 

73-80 Reserved for sequence numbers. 

8 1 -90 Reserved for patch information. 

Source code maintenance as well as other compiler options may be specified by the use of either a $ (dollar 
sign) or & (ampersand) in column 1. (See Appendix A: MIL Compiler Operation.) 

PROGRAM EXAMPLE 

The following pages provide an example of a MIL program. 
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vo 



BURROUGHS S1700 «IL COMPILER* MARS 6. ( 06/06/ 7 6 12:25) 



KCDEL 



THURSDAY, DECEMBER 16, 1976, 02:41 PM. 



NL BLOCK 

NAME 






















c 







































CODE 



MEMORY 
ADDRESS 



loooaoo 

£000000] 
£000100) 
£000108) 
£000100 
£00010CJ 



9300 
0300 
2384 
960C 
G600 
5700 
1800 



[000003 
tOOOlOJ 
£00020) 
£00030) 
£00040) 
£00050) 
£00060] 



XZXZZ2XZZZXZZZZZZZZ2ZZZXZXXZZZZZZZXZZZZZZZZXZX ZZZZZZZZZZ ZZXZZZZXZZZZZZZZ 
X EXAMPLE OF A MIL FROGRAM X 

% THIS PROGRAM DEMONSTRATES SOME DESIRABLE CHARACTERISTICS OF A X 

X MIL PROGRAM. THE PROGRAM "INTERPRETS" ONE 3IT QP-CCDE INSTRUCTIONS Z 
Z FRCM A FIELD IN MEMORY AND PERFCRMS THE INDICATED OPERATION. SINCE Z 
X THERE ARE ONLY TfcO VALUES OF A ONE SIT OP-CODE* THERE ARE ONLY ThO Z 
X INSTRUCTIONS TC CECODE. (IN THIS CASE "ADD" AND "END. OF. JOB" ARE X 
X THE ONLY INSTRUCTIONS.) X 

ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ2ZZZZZZZZZZZZ22ZZZZZZ%ZZZZZXZZZZZZZZZ 

z 
z 

ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ22ZZZZZZZZ222ZZZZZZZZZ2 
ZZZZZZZZZZ GLOBAL DECLARES ZZZ2ZZZZZZ 

ZZZZZZZZZZ ZZZZZZZ2ZZ 

ZZZZZZXZZZZZZZZZZZZZ2ZZZXZZZZZZZZZZZZZZZZZZZZ ZZZZZZZZZZ 
DECLARE 

01 SYSTEN. INFORMATION 



02 
02 
02 
02 



02 



3IT(1668>» 
DEVICE. STATUS. TABLE 311(256), 
AVAILABLE. SYSTEM. MEMORY BIT (8), 
AVAILABLE. CONTROL. MEMORY BIT (4), 
OPTIONS. TABLE 8IT(48), 

03 SWITCHES HI f (8), 

03 FILLER 8IT(40), 

FILLER 3IT£1352>; 



ZXZXXZXXZZZZXZXZZZZZZZZZZZZZZZZZZZZZZZZZZZXZZZZZZZZZZXZ 
ZZZZZZZZZZ GLOBAL DEFINES ZZZZZZZZZZ 

ZZZZZZZZZZ ZZZZZZZZZZ 

ZZZZZZZZZZZZ2ZZZZZZZZZZZZZZZZ22ZZZZZZZZZZZZZZ ZZZZZZZZZZ 
DEFINE ADDR1 = S0# 

DEFINE ADDR2 = Sl# 

DEFINE ADCR3 = S2# 

OEFINE NEXT. INSTRUCTION. POINTER = S4A* 



ZZZZZZZ2Z2ZZZZZZZZZZZ 

BEGINNING. OF. PROGRAM* 

ZZZZZZZZZZ Z2ZZZZZZZZZ 

Z 

Z THIS PART OF THE INTERPRETER ARBITRARILY SETS THE STARTING ADDRESS OF 

Z THE NEXT INSTRUCTION ALONG WITH THE PROGRAM BASE AND LIMIT REGISTERS. 

Z (THIS INFORMATION WOULD NORMALLY 8E FOUND BY SOME OTHER METHOD.) 



MOVE 33002 TC NEXT. INSTRUCT ION. POINTER 

MOVE 36003 TO BR 
MOVE 316003 TO L« 



SEQUENCE 



0C0C0200 
00000300 
00030400 

OC000500 
00000600 
00000700 

ooocosoo 

00000900 
00001000 
0CCC1100 
OC001200 
00001300 
OC001400 
000 Ct 500 
0C00160O 

ooooiroo 

ooocieoo 

00001900 
0C002C00 
CC002100 
OC002200 
00002300 
00002400 
00002500 
OC002600 
00002700 
00002800 
OCOC2900 
000030CO 
00003100 
0CC03200 
00003300 
00003400 
CC003500 
00003600 
0C0O37OO 
OC003800 
00003900 
OCOC4000 
00004100 
0C0042C0 
OC004300 
0C004400 
00004500 
OC004600 
0C004700 
00004800 
0CC04900 
00005000 



PATCH 
INFO 



0C005100 
0C005200 
i 00005300 



FETCH 
FETCH 
FETCH 
FETCH 
FETCH 
1 FETCH 
1 FETCH 
FETCH 
FETCH 
FETCH 



ADO 

ACD 

ADD 

ADO 

ACQ 

ADO 

ADO 

ACQ 

ADO 

ADC 

AGO 
1 AOO 

ADD 

ADD 

ADD 

ADD 

ADD 

ADD 

AGO 

ADD 

ADD 

ACD 

ADO 

ADD 
1 ADD 
1 ACD 




C 

1 END. OF. 
1 END. OF. 
1 END. OF. 










ecia 

2SA4 
7101 
2864 
10A5 
COOO 
C0Q1 
C015 



[C0C701 

EC0C801 
£00090] 
[COCAO! 

tooceoj 

CCO0CO3 
C0OODO3 
[OOOEO] 



3182 

e<590 

£013 
C05C 

E01F 
11A0 
C701 
E01C 
0712 
0033 
0013 
10E2 
0054 
60A8 
C003 

3 OOF 
1002 
1004 

7FAC 
0720 
D011 



3 [0C0F01 

3 [001001 

3 rcouo] 

3 CQC1201 

3 1001301 

3 [C01401 

3 [001501 

3 [001601 

3 C0C1703 

3 £001803 

3 [00190] 

3 CC01A01 

3 [001801 

3 rooicoi 

3 tCOlDOl 

3 [C01E03 

3 [001FC3 

3 [002001 

3 [002101 

3 [002201 

3 [002301 



JG8 

JOB C001 3 [C02401 

JOB 



XXXXX 
FETCH 
XXXXX 
X 



this routine adjusts the 24 bit function box to 24 3it 
binary; reads in a i bit op code; and performs a 
calculated 3ranch to the indicated execution routine. 



BEGIN FETCH 

MCVE 24 TO C 

KCVE NEXT. INSTRUCTION. POINTER TO FA 
READ 1 BIT TO X INC FA 
MOVE FA TO NEXT. 
X TO H 



X 

XXXX 
ADOZ 
XXXX 

* 
ft 

X 
X 
X 
X 



.LOOP 



MOVE 

JUkP FORWARD 

GO TO ADO 

GO TO END.0F..J03 
END FETCH 



•INSTRUCTION. POINTER 



ZGET OP CODE. 



ZOP 0. 
ZOP " 1. 



THIS EXECUTION ROUTINE PERFORMS AN ABSOLUTE* 3 ADDRESS* 
BINARY OR DECIMAL ADD. OVERLAPPING FIELDS ARE PERMITTED. 
LEFT TRUNCATION OR LEFT ZERO FILL WILL OCCUR IN THE 
RESULT FIELD IF IT IS RESPECTIVELY LONGER OR SHORTER 
THAN IS REQUIRED TO CONTAIN THE RESULTANT SUM. ALL 3 
FIELDS MUST 3£ OF THE SAME TYPEt BINARY* 4-BIT DECIMAL 
OR 8-BIT DECIMAL) OR THE RESULT IS NOT OEF.INEC. 



BEGIN ADD 
MCVS 



2 TO FT 
MOVE 144 TO FA 
CALL LGAO. ADDRESSES 
LOAD F FRCM AD0R1 

CALL GET. DATA 
MOVE Y TO X 
XCH ADDR2 F A0DR1 
CALL GET. DATA 
XCH AD033 F AD0R2 
8IAS BY F TEST 

GO TO FETCH 
MOVE SUM TO T 
CARRY SUM 
IF FU E3L 8 THEN 



VINDICATES A 3 ADDRESS INSTRUCTION 
XLENGTH OF 3 AOORESSES 



XGET ADDEND. 

ZGET AUGEND. 
ZEND OF RESULT FIELO ANO INSTRUCTION. 
ZSUPPLY EBCDIC NUMERIC ZONES IF 8-3IT 



BEGIN 



MOVE 3F3 TO TA 

HOVE TA TO TC 

MOVE TA TO T£ 



END 

WRITE REVERSE FROM 
XCH ADDR1 F AD0R3 
GC TC -LOOP 
END ADO 



T DEC FA ANO FL ZWRITE SUM. 



ZZZZZZZZZ 
D.CF.JG3Z 
XXZXXZZXX 



BEGIN END. OF. JOB 

HALT 
ENO END. CF. JOB 



xxxxxxzxzxxxx 

AO. ADDRESSES* 
XXXXXXXXXXXXX 



THIS GENERAL ROUTINE LOADS 1, 2 OR 3 ADDRESSES TO 
SCRATCHPAD ANO UPDATES THE NEXT. INSTRUCT ION. POINTER. 
ALL AD0RES5ES ARE IN THE FOLLOWING FORMAT/ 

A) A 24 BIT* BASE RELATIVE- S-MEMORY ADDRESS 
WHICH IS CONVERTED TO AN A8S0ULUTE ADDRESS 
POINTING AT THE ENO OF A FIELO 1. 



00005400 
00005500 
00CG5600 
00005700 
0C0C5800 
00005900 
OC006000 
0CC06100 
00006200 
00006300 
GC0064CO 
0C00&500 
00006600 
OC006700 
00006800 
0C006900 
OC0C7000 
00007100 
00007200 
00007300 
00007400 
00007500 
O0OC760O 
O0OC770O 
00007800 
OC0C79OO 

ooooecoo 

CC003100 

OC008200 
000CS300 
OC008400 
0C003500 
00008600 
00008700 
00008300 
00003900 
00009000 
00009100 
00009200 

00009300 
0CC09400 
0CO095O0 
00009600 
0C0C9700 
00009800 
00009900 
0CC10000 
00010100 
OC010200 
00010300 
00010400 
00010500 
00010600 
00010700 
00010800 
00010900 
00011000 
0C011100 
00011200 
00011300 
00011400 
00011500 
00011600 



I 



I 



LCAC. 
LOAD. 
LOAD. 
LCAC. 
LCAO. 
LCAO. 
LCAC. 
LCAD. 
LOAO. 
LOAD. 
LCAO. 
LCAO. 
LCAO. 
LCAC • 
LCAO. 
LCAO. 
LCAO. 



ADCRE 
AOCRE 
ADORE 
ACDRE 
AC CPE 
ADCRE 
ACCRE 
ADCRE 
AOCRE 
ADCRE 
AOCRE 
ADCPE 
ACCRE 
ADCRE 
AOCRE 
ACCRE 
ADCRE 



C804 3 C002501 
2664 3 [002601 



16A1 
7588 
7538 
1CEC 
BC30 
1165 
20C0 
1165 
2290 
31F 1 
DOOB 
18A4 



3 
3 

3 

• r- • n r .> A 



GET.OATA 

GET. DATA 0032 

GET.OATA 7760 

GET.OATA 18A4 

GET.OATA 



[002701 
[002801 
[002901 
[002A01 
[002801 
[002C01 
[002001 
[002E01 
[002F01 

r .> A -t f\ t\ » 

a [00310] 

3 [003201 



[003301 
[003401 
[003501 



COOF 3 [003601 

0000 3 [C0370] 

0000 3 [003801 

COOC 2 [00390] 



-LOOP 



B) A 4 BIT TYPE FIELDC0001 FOR BINARY, 0100 
FOR 4-3IT DECIMAL AND 1000 FOR 8-BIT 
DECIMAL); 

CO 4 UNUSED BITS 

0) A 16 BIT FIELD LENGTH INDICATING THE NUMBER 
OF BITS CONTAINED IN EACH FIELO. 

BEGIN LCAD. ADDRESSES 

ADD NEXT. INSTRUCTION. POINTER TO FA X > END OF ADDRESSES 

MOVE FA TO NEXT. INSTRUCTION. POINTER 



MOVE 9P TO Y 

READ 24 BITS REVERSE TO T DEC FA 

READ 24 BITS REVERSE TO X DEC FA 

MOVE SUM TO X 

EXTRACT 16 BITS FROM T(8) TO Y 

MOVE FT TO M 

MOVE SUM TO SOA 

MOVE FT TO M 



ZGET TYPE AND LENGTH, 
ZGET ADDRESS. 
ZADDRESS BASE. 
ZGET LENGTH 
ZSELECT A SCRATCHPAO 
ZADDRESS LENGTH 



X 

XXXXX 

GET.O 

XXXXX 

X 



MCVE T TO SOB ZTYPE AND LENGTH. 

r\r r* fr :>w i TrcT 

feu r i □ i i. i c a i 

GO TO -LOOP 
EXIT 
END LCAD. ADDRESSES 

XXXX THIS GENERAL ROUTINE WILL READ FROM ZERO TO 24 SITS INTO 

ATAZ THE K-«ACHI*E, SET CPU TO THE ENCODED DATA TYPE AND SET 

XXXX CPL TO THE NUMBER OF BITS READ. 

BEGIN GET.OATA 

BIAS BY F 

READ REVERSE TO Y DEC FA AND FL 

r XIT 
END GET.OATA 
FINI 



NC ERRORS DETECTED 

MICRO INSTRUCTION COUNT = C0058 

CAUTIONS $ SUBSET HAS NOT SPECIFIED? THEREFORE* THIS 
PROGRAM SHOULD NOT BE USED ON A B1712/81714. 



00011700 
00011800 
00011900 
0C012000 
0C012100 
00012200 
00012300 
00012400 
00012500 
QC01260Q 
00012700 
00012800 
CC012900 
OC 01 30 00 
C0013100 
0CC13200 
O0C133O0 
00013400 
00013500 
00013600 
OC313700 
0CCI380C 

•J \J V * J7 VU 

OC014000 
0CC14100 
0C0142CO 
00014300 
00014400 
00014500 
00014600 
00014700 
000148-00 
00014900 
00015000 
00015100 
0C015200 
0001530C 



APPENDIX A: MIL COMPILER OPERATION 
CONTROL CARDS 
General 

The purpose of the compiler control card is to allow the programmer to specify option settings to the 
compiler. 

Every MIL control card has either a $ (dollar sign) in column 1 and is called a "dollar card", or has an & 
(ampersand) in column 1 and is called an "ampersand card". Column 73-80 may be used as a sequence 
field. 
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Dollar Cards 
SYNTAX 



$■ 



-*» NO " 

•DEBUG 1 r 

[-—-(literal) — •»» 

HARDWARE.TYPE 



(any-dollar-option-not-in-this-diagram) 



-»► U -»J 



LINES.PER.PAGE</i/era/> 

MERGE -i- 

NOPS 

PAGE 



PASS.END 
PROTECT 
SET 



C&t I -T- 
RESET —J 



- (conditional-inclus ion-identifier)- 



RESET 
NOSEQ 
SEQ — 



•■+ (increment) - 
•(base) 



• (base) + (increment) 



VOID 



TZ 



(terminating-sequence- field) 



J 



J 



LIBRARY 



—■(multi- file-id) 

•-(multi-file-id) I (file-id) - 
——■(pack-id multi) / (file-id) ■ 



DEFAULT 



JZ ~3 

<——■ RESET — * J 
$ (dollar-option > 



(pack-id) I < multifile-id) / (file-id)- 
SET — b — r*" -(condition-inclusion-identifier) • 
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SEMANTICS 
ALLCODE • 

AMPERSAND 

ANALYZE.CODEFILE 

CHECK 
COMPILE 

CONTROL 
DEBUG 



lists all code generated for each MIL statement when 
listing 

lists all ampersand records, except &$ records, when 
listing (default on) 

prints an analysis of the code file at end of source list- 
ing 

checks for sequence errors (default on) 

when reset a fast source listing will be produced with 
no code generation or syntax checking (default on) 

prints all dollar cards when listing; same as SDOLLAR 

for compiler debugging use 



DECK 
DOLLAR 
DOUBLE 
ERROR.FILE 

EXPAND 

EXTERNAL 

FORCE 



punches an object deck 

prints all dollars cards on listing 

double spaces listing when printing 

lists errors and warnings on a separate printer file as 
well as on the main listing 

when listing, prints all statements (including comments) 
within a macro when a macro is invoked 

generates external segment branching code (on by 
default) 

generates a code file regardless of syntax errors 



FRAME 



HARDWARE.TYPE 



HEADINGS 



LINES.PER.PAGE 



U 

s 

M 



lists all IF, BEGIN . . . END statements which condition- 
ally exclude code (default on) 

specifies which hardware processor type will be 
used: S = S-Memory; M = M-Memory; 
U = Universal 

prints all title and subtitle headings at the beginning of 
each page when listing 

specifies the maximum number of lines per page of 
listing 
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LIST 

LISTALL 

LIST.NOW 

LIST.PATCHES 

LISTP 

MERGE 



NEW 

NO 

NOPS 

OLD.LISTING.FORMAT 

PAGE 

PAGE.NUMBERS 

PARAMETER.BLOCK 

PASS.END 
PROTECT 
RELEASE 

RESET 

SEQ 

SET 

SINGLE 

SUBSET 



lists all source records excluding macro records that 
are compiled (default on) 

lists all unconditionally excluded records to be printed 

lists source records when read; same as $ LISTP 

lists all patches from CARDS file when read 

same as $ LIST.NOW 

merges a secondary source file ("CARDS") with the 
primary source file ("SOURCE") replacing primary 
source records by secondary records with the same 
sequence numbers 

creates a new source file ("NEWSOURCE") 

resets any specified dollar option if allowed 

generates NOPs in external linking code for debugging 
purposes 

produces listing in pre-V.l compiler format 

skips to a new page before printing the next line 

puts page number on each new page when listing and puts 
a maximum number of lines on a page (60 by default) 
which can be changed by SLINES.PER.PAGE 

punches a parameter block with the object deck if used 
with $DECK; otherwise only code is punched 

displays compiler pass information on the SPO 

protects SKIP when specified 

generates a release tape with listing, code deck, code file, 
and new source 

resets any specified conditional inclusion option 

resequences source records 

sets any specified conditional inclusion options 

prints single-space listings (default on) 

generates code for Bl 7 10 (S-Memory) Processors; same 
as $HARDWARE.TYPE=S 
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SUPPRESS 
VOID 

XREF 
XREF.ALL 

XREF. LABELS 
XREF. NAMES 
XREF.REGISTERS 



suppresses printing of warning messages 

deletes a specified range of source records. The termina- 
ting sequence range must be exactly 8 characters 

sets XREF.LABELS and XREF.NAMES 

sets XREF.LABELS, XREF.NAMES and XREF. 
REGISTERS 

cross-references all labels 

cross-references all names 

cross-references all registers 

NOTES AND RESTRICTIONS 



1 . Unless otherwise specified (through the MERGE option), the only source of input is the card 
reader. Once $ MERGE has been specified and the first non-$ record has been encountered, 
it is not possible to again indicate "CARDS ONLY". 

2. If no dollar cards are used in the default options are: EXTERNAL, AMPERSAND, CHECK, 
COMPILE, FRAME, LIST and SINGLE. All input will be from the CARDS file. 

3. Options are turned off only through the appearance of NO followed by the option word. Note 
that NO and the option word are separated by at least one blank. 

4. Comments may appear on dollar cards by preceeding the comment with a % (percent sign). 

5. Dollar cards are not included as part of a "NEWSOURCE" file when $ NEW is specified. 
Ampersand Cards 

Syntax 



&• 



•LIBRARY 



DEFAULT - 



-^{multifile, id) / {flle.id) - 



'{multi.file.id)- 



-■*• < pack, id) / < multifile, id) / ■ 

■ ipack.id) /{multi.file.id) I {file. id) 

-»» SET 1— »• < condition.inclusion.identifier) ■ 



^ ac i t— 

_*. RESET * 



$ {dollar. option)- 
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SEMANTICS 
LIBRARY 



DEFAULT 



Causes the specified file to be opened and compiled. Compilation proceeds to 
the end of the Library file with no contribution from any standard primary or 
secondary input file. At end of file, compilation is resumed from the standard 
input files. 

Specifies default settings for one or more conditional inclusion toggles. The 
default setting for a particular toggle will take effect only if no previous $ or 
& card specified a setting for that toggle. 



EXAMPLE: & DEFAULT SET TOG.A RESET TOB.B 
NOTES AND RESTRICTIONS 

1 . A library file is assumed to be a disk file. 

2. The last record in a library file that is to be compiled must be FINI: This record cannot be 
omitted. 

3. All & records are included as part of a "NEWSOURCE" file when $ NEW is specified. 

4. &$ records are listed only when both $ DOLLAR and $ AMPERSAND are specified. 

5. LIBRARY, DEFAULT and $ statements may not be intermixed on a single & card. 

MIL COMPILER FILES 

Some of the internal file names in the compiler and the file uses are listed below. This information will 
find use in label equation at compile time. 



CARDS 

LINE 
PUNCH 

SOURCE 

NEWSOURCE 

LIBSOURCE 

LINESAVE 
CODE.FILE 
PARAM.FILE 



Input file containing control and source records. The DEFAULT bit is set for 
this CARD.READER file. 

Output file for the compile listing. The device is PRINTER or BACKUP. 

Output PUNCH or BACKUP file for the object deck produced when "$ DECK" 
is specified. 

Secondary input file for source records when "$ MERGE" is specified. The 
DEFAULT bit is set on this DISK file. 

Output DISK file for new source records when "S NEW" is specified. The file 
contains 90-byte records, blocked 4. 

Input DISK: file for source records when "$ LIBRARY (file name) is encountered. 
The DEFAULT bit is set for the file. 

A temporary work file containing a copy of the listing. 

A temporary work file containing a copy of the object code. 

A temporary work file containing parameters affecting the object code and the 
listing. 
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MILXREF A temporary disk file containing information to be processed during the cross- 

referencing phase. The file is produced only if one of the "$ XREF" options 
is specified. 

CODE , The actual generated code file. This DISK file contains a maximum of 300 1 80- 

byte records, and may contain only one area. 

ERROR.LINE An auxilliary PRINTER or BACKUP file replicating lines on file LINE that have 

caused syntax errors, and the actual error messages, if "$ ERROR. FILE" has been 
specified. This allows the main listing to go to backup with an immediate indica- 
tion of any syntax errors. 
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APPENDIX B: HARDWARE INSTRUCTION FORMATS AND TABLES 
B 1700 HARDWARE TABLES 

Table B-l. Register Addressing 



Group 
(Row) 
Number 


SELECT (Column) NUMBER 





1 


2 


3 





TA 


FU 


X 


SUM 


1 


TB 


FT 


Y 


CMPX 


2 


TC 


FLC 


T 


CMPY 


3 


TD 


FLD 


L 


XANY 


4 


TE 


FLE 


A 


XEOY 


5 


TF 


FLF 


M 


MSKX 


6 


CA 


BICN 


BR 


MSKY 


7 


CB 


FLCN 


LR 


XORY 


8 


LA 


*TOPM 


FA 


DIFF 


9 


LB 


RESERVED 


FB 


MAXS 


10 


LC 


RESERVED 


FL 


*MAXM 


11 


LD 


*PERR 


TAS 


■U 


12 


LE 


XYCN 


CP 


*MBR 


13 


LF 


XYST 


*MSM 


DATA 


14 


CC 


*INCN 


READ 


CMND 


15 


CD 


RESERVED 


WRIT 


NULL 



* Available on B 1720 systems only 
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Table B-2. Condition Registers 





Bits 





1 


2 


3 


BICN 


LSUY 


CYF 


CYD 


CYL 


XYCN 


MSBX 


X = Y 


X Y 


X Y 


XYST 


LSUX 


INT 


YNEQO 


X NEQO 


FLCN 


FL = SFL 


FL SFL 


FL SLF 


FL NEQ 


*INCN 


PORT DEVICE 
MISSING 


PORT HIGH 
PRIORITY 


PORT INTERRUPT 


PORT LOCKOUT 


cc 


STATE 
LIGHT 


TIMER 
INTERRUPT 


I/O 
INTERRUPT 


CONSOLE 
INTERRUPT 


CD 


MEMORY 
READ DATA 
PARITY ERROR 
INTERRUPT 


MEMORY * 
WRITE/SWAP 
ADDR OUT OF 
BOUNDS OVER- 
RIDE 


MEMORY * 
READ ADDR 
OUT OF BOUNDS 
INTERRUPT 


MEMORY * 
WRITE/SWAP 
ADDR OUT 
OF BOUNDS 
INTERRUPT 



*Available on B 1 720 systems only 



NOTES 

1 . BICN, FLCN, XYST, and XYCN are addressable 
as source registers only. 

2. The TOPM, MBR, and A registers are used to 
determine the memory (control or main) and 
location of the next micro-instruction. 

3. MSMA is control memory and may be addressed 
only from the maintenance Console during tape 
mode. 

4. CPU is destination register only. 

5. NULL always contains a value of 0. Any 
register or scratchpad word to which it is moved 
will be cleared to 0. 
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MICRO NAME 





1 


MC 
2 

I 


3 


4 


MD 
5,6,7 


8 


ME 
9 ,0 


" 


12 


MF 
,3 .4 


,5 


VARIANTS 



00 

000 


1 

01 

001 


10 
010 


11 
011 


100 


101 


110 


111 


REGISTER MOVE 











1 


REG 1 GROUP 
SOURCE REGISTER 


REG 1 
SELECT 


REG 2 
SEL CT 


REG 2 GROUP 
SINK REGISTER 




















SCRATCHPAD MOVE 








1 





REGISTER GROUP 
SOURCE OR SINK 


REG 
SELECT 


MOV 
DIR 


DPW 
1/2 


DOUBLE PAD WORD 
ADDRESS 


MOV DIR: 
1/2 DPW: 


P — R 
LEFT 


R— P 
RIGHT 














4 BIT 
MANIPULATE 








1 


1 


REGISTER GROUP 
4BITS0R&SNK 


REG 
SEL 


MANIPULATE 
VARIANTS 


4BITMANIP. 
LITERAL 


MANIP 
VARIANTS: 


SET 


AND 


OR 


EOH 


INC 


INC 

TEST 


DEC 


DEC 
TEST 


BIT TEST REL 
BRANCH FALSE 





1 








REGISTER GROUP 
4 BIT SOURCE 


REG 
SEL 


TESTBIT 
NUMBER 


DSP 
SGN 


RELATIVE BRANCH 
DISPLACEMENT MAG 


DSP SIGN: 


+ 
















BIT TEST REL 
BRANCH TRUE 





1 





1 


REGISTER GROUP 
4 BIT SOURCE 


REG 
SEL 


TESTBIT 
NUMBER 


DSP 
SGN 


RELATIVE BRANCH 
DISPLACEMENT MAG 


DSP SIGN: 


+ 


" 














SKIP WHEN 





1 


1 


c 


REGISTER GROUP 
4BITSOR &SNK 


REG 
SEL 


SKIP TEST 
VARIANTS 


4 BIT TEST MASK 


SKIP TEST 
VARIANTS^ 


ANY 
CLR/ 


ALL 
CLR/ 


EQL 
CLR/ 


ALL 
CLR 


ANY/ 
CLR/ 


ALL/ 
CLR/ 


EQL/ 
CLR/ 


ALU 
CLR 


READ/WRITE 
MEMORY 


111 


R/W 
VAR 


COUNT FA/FL 
VARIANTS 


DATA REG| TW 
CODE | SGN 


DATA TRANSFER 
WIDTH MAGNITUDE 


R/W VAR: 
CNT VAR: 


READ 
N0P 

X 

+ 


WRT 
FA 
Y 


V 


FAt 
FU 

L 


FAt 
FLt 


FA* 


FLt 


FAt 
FLt 


MOVE B BIT 
LITERAL 













REGISTER GROUP. 
REGSEL IS 2 


ENTIRE B BITS OF 8 BIT LITERAL 


REGSEL: 
TWSIGN: 


MOVE 24 BIT 
LITERAL 










1 


REGISTER GROUP. 
RELSEL IS 2 


8 MOST SIGNIFICANT BITS OF 
FULL 24 BIT LITERAL 




















SHIFT/ROTATE 
T REG 







1 





SINK REGISTER 
GROUP 


SNK REG 
SELECT 


S/R 
VAR 


LEFT SHIFT/ROTATE 
COUNT 


S/R VAR: 


SHFT 


ROT 














EXTRACT FROM 
T REG 







1 


1 


RIGHT BIT POINTER 
FOR EXTRACTION FLD 


SNK REG 
CODE 


EXTRACTION FIELD 
WIDTH 


SINK REG 
CODE: 


X 


Y 


T 


L 










BRANCH 
RELATIVE 


1 1 


DSP 

SGN 


RELATIVE DISPLACEMENT MAGNITUDE 


DSP SIGN: 


+ 


- 














CALL 
RELATIVE 


1 1 1 


DSP 
SGN 


RELATIVE CALLED ADDRESS MAGNITUDE 


DSP SIGN: 


+ 


- 














SWAP MEMORY 














10 


DATA REG 
CODE 


TW- 

SGN 


DATA TRANSFER WIDTH 
MAGNITUDE 


TWSIGN: 
REG CODE: 


+ 
X 


Y 


T 


L 










CLEAR 
REGISTERS 














11 


L 
REG 


T 
REG 


Y 

REG 


X 
REG 


FA 
REG 


FL 
REG 


FU 
REG 


CP 

REG 




















SHIFT/ROTATE 
XOR Y 














10 


S/R DIR 
VARIANT 


X/Y 
VAR 


LEFT OR RIGHT, XO R Y 
SHIFT/ROTATE COUNT 


X/Y VAR: 
S/R, DIR: 


X 

SFT — 


Y 

SFT — 


ROT — 


ROT — 










SHIFT/ROTATE 
X ANDY 














10 1 


S/R DIR 

VARIANT 


LEFT OR RIGHT X AND Y 
SHIFT/ROTATE COUNT 


S/R, DIR 
VARIANTS: 


SFT — 


SFT — 


ROT — 


ROT — 










COUNT FA/FL 














110 


COUNT FA/FL 
VARIANTS 


COUNT SCALAR 
MAGNITUDE 


COUNT FA/ 
FL VAR: 


N0P 


FAt 


FLt 


FAt 
FL* 


FA* 
FLt 


FAt 


FLi 


FAt 
FLt 


EXCHANGE DPW 














1 1 1 


SINK DPW 
ADDRESS 


SOURCE DPW 
ADDRESS 




















SCRATCHPAD 
RELATE FA 














10 








DSP 
SGN 


LEFT HALF PAD 
WORD ADDRESS 


DSP SIGN: 


+ 


- 














MONITOR 














10 1 


LITERAL OCCURRENCE IDENTIFIER 




















DISPATCH 


^0 














1 


DISPATCH I SKP 
VARIANTS | FLG 


SKP FLAG: 
DISP VAR: 


FAIL 
LOCK 


SUCC 
WRTLO 


READ 


R&C 


WRITHI 


ABSNT 


UNDEF 


UNDEF 


CASSETTE 
CONTROL 

















10 


CASSETTE 
MANIP VARIANTS 


CASSETTE 
MANIP: 


START 
TAPE 


STOP® 
GAP 


STOP ON 
X?Y 


UNDEF 


UNDEF 


UNDEF 


STOP ON 
X- Y 


UNDEF 


BIAS 

















11 


BIAS | TST 
VARIANTS I FLG 


TEST FLG: 
BIAS VAR: 


TST/ 
UNIT 


TEST 

F 


S 


F5 


N0P 


FCP 


N0P 


NOP 


STORE F INTO 
DPW 

















10 


SINK DPW 
ADDRESS 




















LOAD F FROM 
DPW 

















1 1 


SOURCE DPW 
ADDRESS 




















CARRY FF 
MANIPULATE 

















110 


CYF 
CYD 


CYF 
CYL 


CYF 
! 


CYF 





















HALT 




















1 




















OVERLAY 
M-STRING 




















10 




NORMALIZE X 




















11 




TRANSFER 
CONTROL 




















10 




NO OPERATION 


























w 

LO 



Table B-3. Microinstructions 



Table B-4. Variant Field Definitions 



FOUR-BIT MANIPULATE 


SKIP WHEN (6nnn) SKIP 


READ/WRITE MEMORY 


(3nnn) VARIANTS 


TEST VARIANTS 


(7nnn) VARIANTS 


BITS 4-6 CONDITIONS 
000 SET 


BITS 4-6 CONDITIONS 


BITS 6-7 CONDITIONS 
00 X REG. 


000 ANY. SKIP 


001 AND 


001 ALL. SKIP 


01 Y REG. 


010 OR 


010 EQU. SKIP 


10 T REG. 


011 EOR 


011 ALL CLR. SKIP 


1 1 L REG. 


100 INC 


100 NOT ANY. SKIP 




101 INC/TEST 


101 NOT ALL. SKIP 


BITS 8-10 CONDITIONS 


110 DEC 


110 NOT EQU. SKIP 




1 1 1 DEC/TEST 


1 1 1 NOT ALL. CLR. SKIP 


000 NOP 

001 FA UP 






EXTRACT FROM T REG. 


SWAP MEMORY 


010 FLUP 


(8nnn) VARIANTS 


(02nn) VARIANTS 


011 FAUPFLDN 
100 FADN FLUP 


BITS 5-6 - CONDITIONS 


BITS 6-7 CONDITIONS 


101 FADN 
110 FLDN 




00 X REG. 

01 Y REG. 


00 X REG. 

01 YREG. 


111 FA DN FL DN 




10 T REG. 


10 YREG. 


CASSETTE CONTROL 


1 1 L REG. 


11 LREG. 


(002n) VARIANTS 
BITS 3-1 CONDITIONS 


COUNT FA AND FL 
(06nn) VARIANTS 


DISPATCH (OOln) 
VARIANTS 








000 START TAPE 


BITS 5-7 CONDITIONS 


BITS 1-3 CONDITIONS 


001 STOP ON GAP 
010 STOP ONXNEQY 




000 NOP 


000 DISPATCH LOCK 


011-111 RESERVED 


001 FA UP 


00 1 DISPATCH WRITE 




010 FLUP 


010 DISPATCH READ 


BIAS 


011 FAUPFLDN 


01 1 DISPATCH RD & CLR 


(003n) VARIANTS 


100 FA DN FLUP 


100 RESERVED 




101 FADN 


101 RESERVED 


BITS 3-1 CONDITIONS 


110 FLDN 


110 RESERVED 




111 FA DN FL DN 


1 1 1 RESERVED 


000 FU 

001 24 0RFL 

010 24 0RSEL 

011 24 OR FL OR SFL 

100 NOP 

101 24 OR CPL OR FL 
111 OR SFL 
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B 1700 HARDWARE INSTRUCTION FORMATS 
Bias 



OP 






BIAS 


TESTCPL NEQO FLAG 


CODE 






VARIANTS (V) 


■ NO TEST 


0000 


0000 


0011 


0.. .7 


1 TESTCPL RESULT 



11 12 



14 



15 



This instruction sets CPU to the value 1 if the value of FU is 4 or 8 and to otherwise, unless V = 2. If 
V = 2, the value of the CPU is determined by SFU in lieu of FU. SFU is the first 4 bits of the scratchpad 
word SOB. (On the B 1 7 10, FU = 8 will set CPU = 0.) 

The value of CPL is also set to the smallest of the values denoted in the following table. 

V VALUES 






FU 


1 


24 or FL 


2 


24 or SFL 


3 


24 or FL or SFL 


4 


CPL 


5 


24 AND CPL AND FL 


6 


CPL 


7 


CPL (not defined on the B 1710) 



If the test flag equals 1 and the final value of CPL is not 0, the next micro-instruction is skipped. 
Bit Test Branch False 



OP 


REGISTER 


REGISTER 


REGISTER 


DISPLACEMENT 


DISPLACEMENT 


CODE 


GROUP # 


SELECT # 


BIT # 


SIGN 


VALUE 


0100 


0. . . 15 


0.. . 1 


0. . 3 


0- POSITIVE 
1 -NEGATIVE 


0. . 15 



3 4 



10 



11 



12 



f5 



This micro-instruction tests the designated bit within the specified register and branches (relative to the 
next micro-instruction) by the amount and direction of the signed displacement value if the bit is 0. If 
the bit is 1 , a displacement value of is assumed, and control passes to the next in-line micro-instruction. 
A displacement value indicates the number of 1 6-bit words from the next in-line micro-instruction. A 
negative sign indicates lower addresses (backward displacement). The maximum displacement is 1 5 micro- 
instructions. 
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Bit Test Branch True 



NOTE 

Register Bit # is read from right to left, - 3 in 
accordance with the hardware bit numbering 
convention. 



OP 


REGISTER 


REGISTER 


REGISTER 


DISPLACEMENT 


DISPLACEMENT 


CODE 


GROUP # 


SELECT # 


BIT# 


SIGN 


VALUE 


0101 


. . 15 


0... 1 


0...3 


POSITIVE 

1 NEGATIVE 


0. . . 15 



3 4 



10 



11 



12 



15 



This instruction tests the designated bit within the specified register and branches (relative to the next 
instruction) by the amount and direction of the signed displacement value if the bit is 1. If the bit is 0, 
a displacement value of is assumed, and control passes to the next in-line micro-instruction. A dis- 
placement value indicates the number of 1 6-bit words from the next in-line micro-instruction. A negative 
sign indicates lower addresses (backward displacement). The maximum displacement is 1 5 micro-instruc- 
tions. 

NOTE 

Register Bit # is read right to left, - 3 in 
accordance with hardware bit numbering 
convention. 

Branch 



OP 

CODE 

110 


DISPLACEMENT SIGN 

POSITIVE 

1 -NEGATIVE 


DISPLACEMENT VALUE 
. . . 4095 



15 



This instruction fetches the next micro-instruction from the location obtained by adding the signed dis- 
placement value given in the instruction to the address of the next in-line micro-instruction. 

A displacement value indicates the number of 1 6-bit words. 
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Call 



OP 

CODE 

111 


DISPLACEMENT SIGN 
0- POSITIVE 
1 NEGATIVE 


DISPLACEMENT VALUE 
. . . 4095 



15. 



This instruction pushes the address of the next in-line micro-instruction (already contained in A register) 
into the A stack and then fetches the next micro-instruction from the location obtained by adding the 
signed displacement value given in the instruction to the address of the next in-line micro-instruction. 

A displacement value indicates the number of 1 6-bit words. 

NOTES 

1 . EXIT, the opposite of CALL, is accomplished 
by employing the MOVE register instruction 
with TAS as the source register and A as the 
sink register. 

2. When the A address is stored in the A stack, 
it is multiplied by 1 6 and stored as a bit 
address. 

Cassette Control 



OP 

CODE 

0000 0000 0010 


CASSETTE MANIPULATE 
VARIANTS (V) 
... 7 


RESERVED 
FLAG BIT 
0. .. 1 



11 12 



14 



15 



This instruction performs the indicated operation on the tape cassette. 



v = 




1 

2 
3 


Start Tape 

Stop Tape 

Stop Tape if XNEQY 

Reserved 




4 


Reserved 




5 


Reserved 




6 


Reserved 




7 


Reserved 



All Stop Tape variants cause the tape to halt in the next available gap. 
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Clear Registers 









REGISTER FLAGS 




OP 






8-BITS 




CODE 
0000 










0011 


L 


T 


Y 


X 


F 


F 


F 


C 














A 


L 


U 


P 



7 8 



15 



This micro-instruction clears the specified register(s) to if the respective flag bit is 1 . 
Count FA/FL 



OP 

CODE 

0000 0110 


COUNT 
VARIANTS (V) 
0. . . 7 


LITERAL 
. . 31 



7 8 



10 11 



15 



This micro-instruction increments (decrements) binarily the designated register(s) by the value of the 
literal contained in the micro-instruction or by the value of CPL if the value of the literal is 0. 

Neither overflow nor underflow of FA is detected. The value of FA may go through its maximum value 
or its minimum value and wrap around. 

Overflow of FL is not detected. The value of FL may go through its maximum value and wrap around. 
Underflow of FL is detected and will not wrap around. The value is left in FL. 

Literal values (or CPL values if LIT=0) of 25 through 3 1 are truncated to the value 24. 

Count variants are as follows: 

V= 000 No Count 

001 Count FA UP 

010 Count FL UP 

1 1 Count FA UP and FL DOWN 

1 00 Count FA DOWN and FL UP 

101 Count FA DOWN 

110 Count FL DOWN 

111 Count FA DOWN and FL DOWN 
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Dispatch 



(Requires a hardware I/O subsystem available on the B 1720 only) 



OP 


DISPATCH 


SKIP VARIANT 


CODE 


VARIANTS 


(Applies only to 


0000 0000 0001 


000 - LOCKOUT 


lockout variant) 




001 -WRITE 


- SKIP IF ALREADY LOCKED 




010- READ 


1 -SKIP IF NOT ALREADY LOCKED 




011 -READ AND CLEAR 






100-WRITE HIGH 






101 -PORT ABSENT 





11 12 



14 



15 



This micro-instruction sends/receives interrupt and interrupt information to/from other ports. 

Since the interrupt system is shared by all ports, the processor should gain control of the interrupt system 
by successfully completing a LOCKOUT prior to a DISPATCH WRITE. 

LOCKOUT sets the lockout bit in the DISPATCH register and allows, via the skip variant, skipping or not 
skipping the next 16-bit instruction based upon the success or failure (already set) of the LOCKOUT. 

WRITE (High or Low) DISPATCH sets the Lockout and Interrupt flip flops in the port interchange. It 
also stores the contents of the L register into memory location to 23 and the contents of the least- 
significant seven bits of the T register (designating the destination port* and channel # ) into the appro- 
priate port interchange register. In addition, it sets (Write High) or resets (Write Low) the high Interrupt 
flip flop in the port interchange. 

READ DISPATCH stores the contents of memory locations through 23 into the L register and the 
contents of the Port Channel register into the least significant 7 bits of the T register. The other 1 7 bits 
of T are unaffected. 

READ AND CLEAR DISPATCH in addition to performing the READ DISPATCH operation clears the 
lockout flip flop, the two interrupt flip flops and the Port Device Absent flip flop in the port interchange. 
It does not clear any memory locations. 

PORT ABSENT is executed by the processor when necessary to return a Port Device Absent Level signal 
to another port indicating the absence of the designated channel. 

Dispatch operations in the case of Processor-2 and Processor Adapter- 1 (direct connect to memory) are 
limited to the following: 

a. LOCKOUT + SKIP-IF-NOT-ALREADY-LOCKED: always skips. 

b. WRITE LOW: always sets Port Device Absent Level true (true indicates absence). 

c. READ and CLEAR: always sets the Port Device Absent level false (false indicates present). 
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No changes occur in the T and L registers. In the INCN register only the Port Device Absent bit can 
change. The Lockout, the Interrupt, and High Priority bits will always be false. No other dispatch 
operations are defined. 

Extract From T 



OP 


ROTATE 


DESTINATION 


EXTRACT 


CODE 


BIT COUNT 


REGISTER 


BIT COUNT 


1011 


... 24 


00 -X 
01 -Y 
10-T 
11 - L 


... 24 



3 4 



8 9 



10 11 



15 



This micro-instruction rotates the T register contents left by the ROTATE count, extracts the bits specified 
and moves the result to the sink register. If the extract bit count is less than 24, the data is right-justified 
with the left (most-significant) zero bits supplied. 

The contents of the T register are unchanged unless it is also the sink register. 

A rotate value of 24 is equal to and is equivalent to a NO OPERATION. 

NOTE 

The microprogramming language compiler uses the 
left-most bit to be extracted and calculates the 
rotate bit count to be used by the hardware circuits. 
The assembler addresses the bits within the T regis- 
ter left to right as through 23; hardware addresses 
the bits right to left as through 23. 

Four-Bit Manipulate 



OP 


REGISTER 


REGISTER 


MANIPULATE 


LITERAL 


CODE 


GROUP # 


SELECT* 


VARIANTS (V) 




0011 


0... 15 


0...1 


. 0...7 


0...15 



3 4 



11 12 



15 



This micro-instruction performs the operation specified by the variants on the designated register. 

V = The register is set to the value of the literal. 

1 The register is set to the logical AND of the register and literal. 

2 The register is set to the logical OR of the register and literal. 

3 The register is set to the logical EXCLUSIVE-OR of the register and literal. 

4 The register is set to the binary sum (modulo 16) of the register and literal. 
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5 The register is set to the binary sum (modulo 16) of the register and literal, and the next 
micro-instruction is skipped if a carry is produced. 

6 The register is set to the binary difference (modulo 1 6) of the register and the literal. 

7 The register is set to the binary difference modulo 16 of the register and literal, and 
the next micro-instruction is skipped if a borrow is produced. 

EXCEPTION 

BICN, FLCN, XYCN, XYST, INCN (B1720) and CPU 
(B 1710) when specified as operand registers are not 
changed as a result of this operation. However, the 
carry or borrow outputs are produced and a skip can 
result. 



Halt 



OP CODE 
0000 0000 0000 0001 



15 



This micro-instruction stops the execution of the micro-instructions. In RUN mode the next micro to be 
executed is fetched and stored in the M register, and the A register points to the next following micro. 
In TAPE mode the next micro is not fetched and stored in the M register, but the HALT micro is left in 
the M register. 

The register indicated by the register select switch will be displayed. 

Load F From Doublepad Word 

(Available on B 1720 systems only.) 



OP 






SCRATCHPAD 


CODE 






WORD ADDRESS 


0000 


0000 


0101 


0...15 



11 12 



15 



This micro-instruction moves the contents of the A and B portions of the designated scratchpad word to 
the FA and FB registers respectively. 
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Monitor 

(Available on B 1720 systems only.) 



OP CODE 

oooo 1001 



VARIANTS 
6, 5, 4, 3, 2, 



7 8 



15 



This micro-instruction skips to the next sequential instruction. 

During the time this micro-operator is executing the operator and the last two bits (0 and 1) are decoded, 
ANDed with the system clock and are present in the backplane as follows: 

True for the OP Code 
True if last two bits are 00 
True if last two bits are 1 
True if last two bits are 10 
True if last two bits are 1 1 

At the backplane, the monitors are one-half clock from leading edge to trailing edge. 

Move 8-Bit Literal 



MONITOR 





MONITOR 


00R0 


MONITOR 


01 RO 


MONITOR 


02R0 


MONITOR 


03 RO 



OP 


DESTINATION 


LITERAL 


CODE 


REGISTER 




1000 


GROUP 3 
0...15 


... 255 



3 4 



7 8 



15 



This micro-instruction moves the 8-bit literal given in the micro-instruction to the sink register. If the 
move is to a register of length > 8 bits, the data is right-justified with left (most-significant) zero 
bits supplied. 

EXCEPTIONS 

1 . READ and WRITE are excluded as sinks. 

2. When M is used as a sink register, the operation is 
changed to a bit-OR which modifies the next 
micro-instruction. It does not modify the micro- 
instruction as stored in memory. 
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Move 24-bit Literal 



OP 


DESTINATION 


24 - BIT LITERAL 


CODE 


REGISTER 




-J 001 


GROUP# 
0...15 


0...@FFFFFF® 



3 4 



7 8 



1 5 of "next" micro 



This micro-instruction moves the 24-bit literal given in the double-length micro-instruction to the sink 
register. If the move is between registers of length < 24 bits, the literal is truncated from the left. 

EXCEPTIONS 

1 . READ, WRITE, M and CP (B 1 7 1 0) are excluded 
as sinks. 

2. The MSMA register (available only on the B 1720) 
may be a sink only in the TAPE mode. 

No Operation 



OP 

CODE 

0000 



0000 0000 



0000 



15 



This micro-instruction initiates a skip to the next sequential micro-instruction. 
Normalize X 




This micro-instruction shifts the X register left while counting FL down until FL = or until the bit in 
X referenced by CPL = 1 . Zeros are shifted into the right-most end of X. 

CPL = 1 references the right-most bit of X while CPL = 24 references the left-most bit of X. If CPL = 0, 
the operation will continue until FL = 0. 
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Overlay Control Memory 

(Available on B 1720 systems only.) 




This micro-instruction overlays control memory (M-Memory) from main memory. 

The starting main memory address is in the FA register; the length of the data to be overlaid, in bits, is in 
the FL register. The starting control memory address is in the L register. 

Execution of the micro-instruction proceeds as follows: 

a. The contents of the A register are moved to the TAS register. 

b. The contents of the L register are moved to the A register. 

c. The first 16 bits of data are read from main memory and stored in the control memory 
via register L. Register FL is decremented by 16 bits; FA is incremented by 16 bits; 
and A is incremented by 1 word. 

d. Step 3 is repeated until FL = or A MAXM, at which point the process terminates 
with a move of TAS to A. 

e. The operation then continues with the next micro-instruction. 
Read/Write Memory 



OP 


DIRECTION 


COUNT 


REGISTER 


FIELD, 


MEMORY 


CODE 


TO REGISTER 


VARIANTS 


00 -X 


DIRECTION 


FIELD 


0111 


1 TO MEMORY 


... 7 


01 - Y 


0- POSITIVE 


LENGTH 








10 -T 


1 -NEGATIVE 


... 26 








11 - L 







10 



11 



15 



This micro-instruction moves the contents of the register (memory) to the memory (register). If the value 
of the memory field length is less than 24, the data from memory is right-justified with left (most-signifi- 
cant) zero bits supplied while the data from the register is truncated from the left. 

The contents of the source is unchanged. 
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Register FA contains the bit address of the memory field while the memory field direction sign and memory 
field length are given in the instruction. 

If the value of the memory field length as given in the instruction is 0, the value in GPL is used. 

Memory field length values (or CPL values if Memory Field Length = 0) of 25 and 26 are truncated to the 
value of 24. When used on a WRITE operation, the value 25 and 26 cause odd and even parity respectively 
to be written into memory regardless of the parity of the read data. 

For a description of the count variants, see COUNT FA/FL. 

Read/Write MSM 

(Available on B 1720 systems only.) 



OP 

CODE 

0000 0000 01 1 1 


VARIANTS 


R/W VARIANT 

OtoX 

1 FROM X 


G/B 


H/F 


S/N 



11 12 13 14 



15 



This micro-instruction (1) moves the contents of the X register to the M-Memory word specified by the 
address contained in the L register if the R/W variant bit = 1 ; data is right justified with left (most signi- 
ficant) bits supplied or (2) moves the contents of the M-Memory word specified by the address contained 
in the L register to the X register if the R/W variant bit = 0; data is right justified with left (most signifi- 
cant) zero bits supplied. 

The lower 4 bits and the upper 8 bits of the address in L are ignored. 

READ/WRITE MSM causes the A register to be moved to the TAS register and the L register to be moved 
to the A register before the instruction is executed. The TAS is restored to A after the READ/WRITE 
MSM operation is completed. 

The S variant is used to enable the set/reset of the G/B and H/F flip flops. If S = 1 , the G/B and H/F flip 
flops are set/reset by the G/B and H/F variants. If S = 0, no change is made in the G/B and H/F flip flops. 

If the G/B flip flop is true, all READ/WRITE MSM operations will force bad parity in the addressed word. 
If the G/B flip flop is false, all READ/WRITE MSM operations will force good parity in the addressed 
word. 

If the M/F flip flop is true, the processor upon reading an M-Memory word containing parity error will 
flag the error condition by setting a CD bit true. It will not halt. If the H/F flip flop is false, the pro- 
cessor upon detection of a parity error in reading an M-Memory word will flag the error condition by 
setting PERR bit 1 true and then halt. Reading an M-Memory word occurs when fetching a M-op from 
M-Memory or when moving an M-Memory word to any destination. 

The H/F and G/B flip flops are cleared to zero (false) with the CLEAR signal. If S = 1, the G/B and H/F 
flip flops are set/reset prior to the execution of the READ /WRITE MSM portion of the operation. 
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Register Move 



OP 


SOURCE! 


SOURCE 


DESTINATION 


DESTINATION 


CODE 


REGISTER 


REGISTER 


REGISTER 


REGISTER 


0001 


GROUP # 


SELECT # 


GROUP # 


SELECT* 




0...15 


0...3 


0...3 


0. .. 15 



3 4 



7 8 



9 10 



11 12 



15 



This micro-instruction moves the contents of the source register to the sink register. If the move is between 
registers of unequal lengths, the data is right-justified with left (most-significant) zero bits supplied or the 
data is truncated from the left, whichever is appropriate. 

t 

The contents of the source register are unchanged unless it is also the sink register. 

EXCEPTIONS 

1 . WRIT, CMND (and CPU, READ on B 1 720) are 
excluded as source registers. 

2. When the M register is used as a sink in RUN or 
STOP mode, the operation is changed to an bit- 
OR which modifies the next micro-instruction. 
It does not modify the instruction stored as 

in memory. In TAPE mode, no bit-OR 
takes place. 

3. BICN, FLCN, XYCN, XYST, INCN, READ, 
WRIT, SUM, CMPX, CMPY, XANY, XEOY, 
XEOR, MSKX, DIFF, MAX, MAXM, and U 
are excluded as sink registers. 

4. U is excluded as a source register in the STEP 
mode. 

5. When DATA (and SUM, DIFF on B 1710) is 
designated as a source, CMND, and DATA are 
excluded as sinks. 

6. On the B 1 7 1 when A, M, CP, or DATA is 
designated as a source, all 4-bit registers are 
prohibited as sinks. 

7. On the B 1 720, when U or DATA is designated 
as a source and when the next micro-instruction 
is to be obtained from main memory, M is ex- 
cluded as a sink. 
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Scratchpad Move 



OP 


REGISTER 


REGISTER 


DIRECTION 


SCRATCHPAD 


SCRATCHPAD 


CODE 


GROUP# 


SEI_ECT# 


0-TO 


WORD 


WORD 


0010 


0...15 


0...3 


SCRATCHPAD 


0- LEFT WORD 


ADDRESS 








1 - FROM 


1 -RIGHT 


0...15 
i 








SCRATCHPAD 


WORD 





3 4 



7 8 



10 



11 



12 



15 



This micro-instruction moves the contents of the register (scratchpad) to the scratchpad (register). If 
the move is between fields of unequal lengths, the data is right-justified with left (most-significant) zero 
bits supplied or the data is truncated from the left, whichever is appropriate. 

The contents of the source register are unchanged. 

EXCEPTIONS 

1 . When the M register is used as a sink, the 
operation is changed to a bit-OR which 
modifies the next micro-instruction. It does 
not modify the micro-instruction as stored 
in memory. 

2. BICN, FLCN, XYCN, XYST, INCN, READ, 
WRIT, SUM, CMPX, CMPY, XANY, XORY, 
XEOY, MSKX, MSKY, DIFF, MAXS, MAXM 
and U are excluded as sink registers. 

3 . WRIT, CMND (and CPU, READ on B 1 7 1 0) 
are excluded as source registers. 

4. U is excluded as a source in STEP mode. 

5. On the B 1 7 1 M as a source results in a trans- 
fer of 24 zeros. 

Scratchpad Relate FA 



OP 




RESERVED 


SIGN OF SCRATCHPAD 


LEFT HALF ADDRESS 


CODE 






0- POSITIVE 


OF A SCRATCHPAD WORD 


0000 


1000 


000 


1 - NEGATIVE 


0... 15 



10 



11 



12 



15 
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This micro-instruction replaces the contents of the FA register by the binary sum of FA and the left half of 
the specified scratchpad word. 

Neither overflow nor underflow of FA is detected. The value of FA may go through its maximum value or 
its minimum value and wrap around. 

Set CYF 



OP 






SET 


CODE 






VARIANTS (V) 


0000 


0000 


0110 


1, 2, 4, 8 



11 12 



15 



This micro-instruction sets the carry flip-flop as specified by the variants. 

V= 1 Set CYF to 

2 Set CYF to 1 

4 Set CYF to CYL (carry total from sums) 

8 Set CYF to CYD (carry borrow from difference) 

NOTES 

1 . CYL is generated under the control of the 
length in CPL. 

2. CYF is an input to the arithmetic logic along 
with the X and Y registers. CYF is the left-most 
bit of the CP portion of the C register. 

Shift/Rotate T Left 



OP 


DESTINATION 


DESTINATION 


SHIFT/ROTATE 


SHIFT/ROTATE 


CODE 


REGISTER 


REGISTER 


0- SHIFT 


BIT COUNT 


1010 


GROUP # 
0... 15 


SELECT* 
0...3 


1 - ROTATE 


... 24 



3 4 



7 8 



10 



11 



15 



This micro-instruction shifts (rotates) register T left by the number of bits specified and then moves the 
24-bit result to the sink register. If the move is between registers of unequal lengths, the data is right- 
justified, with data truncated from the left. 

The contents of the T register are unchanged unless it is also the sink register. 

Zero fill on the right and truncation on the left occurs with the shift operation. ROTATE is an end-around 
shift with no truncation or fill. 
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If the value of the SHIFT/ROTATE COUNT as given in the instruction is 0, the value given in CPL is 
used. 



1. 



2. 



Shift/Rotate XY Left/Right 



EXCEPTIONS 

When the M register is used as a sink register, 
the operation is changed to a bit-OR which 
modifies the next micro-instruction. It does 
not modify the micro-instruction as stored 
in memory. 

BICN, FLCN, XYCN, XYST, INCN, READ, 
WRIT, SUM, CMPX, CMPY, XANY, XEOY, 
XORY, DIFF, MAXS, MAXM and U are 

excluded as sink registers. 



OP 


SHIFT/ROTATE 


SHIFT/ROTATE 


SHIFT/ROTATE 


CODE 


VARIANT 


DIRECTION 


BIT 


0000 0101 


0- SHIFT 


VARIANT 


COUNT 




1 ■ ROTATE 


0-LEFT 
1 -RIGHT 


... 48 



10 



15 



This micro-instruction shifts (rotates) register X and Y left (right) by the number of bits specified. The 
register X is the left-most (most-significant) half of the concatenated 48-bit XY register. Only a count 
of one may be specified on the B 17 10 for the concatenated XY register. 

Zero fill on the right and truncation on the left occurs with the left shift. Zero fill on the left and trun- 
cation on the right occurs with the right shift. 

If the value of the SHIFT/ROTATE COUNT as given in the micro-instruction is 0, the operand is shifted/ 
rotated by the amount determined by CPU as follows: 

CPU SHIFT/ROTATE COUNT 



00 


lbit 


01 


4 bits 


10 


Undefined 


11 


8 bits (available only on B 1720 systems) 



NOTE 

The shift by CPU option is available only on 
B 1 720 systems. 
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Shift/Rotate X/Y Left/Right 



OP 




SHIFT/ROTATE 


SHIFT/ROTATE 


X/Y 


SHIFT/ROTATE 




CODE 




VARIANT 


DIRECTION 


VARIANT 


BIT 




0000 


0100 


0-SHIFT 


0-LEFT 


0-X REG 


COUNT 








1 ■ ROTATE 


1 -RIGHT 


1 -Y REG 


... 24 





7 8 9 10 11 15 

This micro-instruction shifts (rotates) register X or Y left or right by the number of bits specified. 

Zero fill on the right and truncation on the left occurs with the left shift. Zero fill on the left and trunca- 
tion on the right occurs with the right shift. 

If the value of the SHIFT/ROTATE COUNT as given in the micro-instruction is 0, the operand is shifted 
(rotated) by the amount determined by CPU as follows: 

CPU SHIFT/ROTATE COUNT 



00 
01 
10 

11 



1 bit 

4 bits 

Undefined 

8 bits (not available on B 1710 systems) 

NOTE 

The shift by the CPU option is available on B 1 720 
systems only. 



Skip When 



OP 


REGISTER 


REGISTER 


SKIP TEST 


MASK 


CODE 


ROW# 


COLUMN* 


VARIANTS (V) 


0.. . 15 


0110 


0...15 


0. .. 1 


0...7 





3 4 



11 12 



15 



This micro-instruction tests only the bits in the register that are referenced by the 1 bits in the mask and 
ignores all others. It then performs the actions specified below. Exception: If V = 2 or V = 6, it compares 
all bits for an equal condition. 

V = If any of the referenced bits are l's, the next micro-instruction is skipped. 

1 If all the referenced bits are 1 's, the next micro-instruction is skipped. 

2 If the register is equal to the mask, skip the next micro-instruction. 
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This is the same as V = 1 , but the referenced bits are also cleared to 
without affecting the non-referenced bits. 

If any of the referenced bits are 1 's, the next micro-instruction is not 
skipped. 

If all the referenced bits are 1 's, the next micro-instruction is not 
skipped. 

If the register is equal to the mask, the next micro-instruction is not 
skipped. 

This is the same as V = 5, but the referenced bits are also cleared to 
without affecting the non-referenced bits. 

NOTES AND RESTRICTIONS 

1 . If the mask equals 0000 the ANY result is false. 
The skip is made for V = and is not made for 
V = 4. If the mask equals 0000, the ALL result 
is true. The skip is made for V = 5 and V = 7 
and is not made for V = 1 and V = 3. 

2. BICN, FLCN, XYCN, XYST, and cannot be 
cleared with V = 3 or V = 7. However, they can 
be tested. 



Store F Into Doublepad Word 

(Available on B 1720 systems only.) 



OP 






SCRATCHPAD 


CODE 






WORD ADDRESS 


0000 


0000 


0100 


0... 15 



11 12 15 



This micro-instruction moves the contents of the FA and FB registers to the designated scratchpad word. 
FA is transferred to the A half of the scratchpad word, and FB (which contains FL, FT, and FU) is trans- 
ferred to the B scratchpad word. 

The contents of FA and FB remain unchanged. 
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Swap F with Doublepad Word 



OP 


DESTINATION 


SOURCE 


CODE 


48-BIT 


48-BIT 


0000 0111 


SCRATCHPAD 


SCRATCHPAD 




WORD 


WORD 




0... 15 


0...15 



7 8 



11 12 



15 



This micro-instruction moves the contents of the FA and FB registers to a hardware holding register. 
It then moves the contents of the left and right word of the source scratchpad word to the FA and FB 
register respectively, and moves the contents of the hardware holding register to the destination scratch- 
pad word. 

Swap Memory 

(Available on B 1720 systems only) 



OP 


REGISTER* 


FIELD 


MEMORY 


CODE 


oo-x 


DIRECTION 


FIELD 


0000 0010 


01 -Y 


0- POSITIVE 


LENGTH 




10-T 


1 - NEGATIVE 


... 24 




11 * L 







7 8 



10 



11 



15 



This micro-instruction swaps data from main memory with the data in the specified register. If the value 
of the memory field is less than 24, the data from memory is right-justified with left (most-significant) 
zero bits supplied. The data from the register is truncated from the left before entering memory. 

Register FA contains the absolute binary address of the main memory field while the field direction sign 
and field is given in the instruction. 

If the value of the memory field length as given in the instruction is 0, the value given in CPL is used. 
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Transfer Control 



OP CODE 

0000 0000 0000 



0100 



15 



This micro-instruction moves the 24-bit value from the L register to the MBR register; moves the least 
significant 4 bits from the T register to the TOPM register; and moves the most significant 20 bits from 
the T register to the A register, truncating the left most 6 bits of the source. 
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MICRO-INSTRUCTION TIMING 



Table B-5 : Micro-Instruction Timing 



B1710 




B1720 


Notes 


Clocks 


Micro-Instructions 


Clocks Notes 




2 


BIAS 


1 




1 


BIND 


3 




2 


BIT TEST BRANCH FALSE 






2 


BIT TEST BRANCH TRUE 






4 


BRANCH 


1 1 


1 


5 


CALL 






2 


CASSETTE CONTROL 






- 


CLEAR REGISTERS 






4 


COUNT FA/FL 






- 


DISPATCH 


6/5 




3 


EXTRACT FROM REGISTER T 






2 


FOUR-BIT MANIPULATE 






2 


HALT 






- 


LOAD F FROM DOUBLEPAD WORD 






2 


MONITOR 






2 


MOVE 8-BIT LITERAL 






6 


MOVE 24-BIT LITERAL 






2 


NO OPERATION 




3 


6 


NORMALIZE X 


1 2 




- 


OVERLAY CONTROL MEMORY 


5 3 




8 


READ/WRITE MEMORY 


5/4 4 




- 


READ/WRITE MSM 




2 


2 


REGISTER MOVE 




2 


2 


SCRATCHPAD MOVE 






4 


SCRATCHPAD RELATE FA 






2 


SET CYF 






3 


SHIFT/ROTATE REGISTER T LEFT 




4 


6 


SHIFT/ROTATE XY LEFT/RIGHT 


1 2 




3 


SHIFT/ROTATE X/Y LEFT/RIGHT 


1 2 




2 


SKIP WHEN 






- 


STORE F INTO DOUBLEPAD WORD 






10 


SWAP F WITH DOUBLEPAD WORD 


2 




- 


SWAP MEMORY 


4 5 
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B 1710 Notes 

The basic clock of the B 17 10 is 4 megahertz. 

1. This includes the fetch of the called micro-instruction. 

2. For BCD result register moves, there are three clocks. 

3. There are six clocks per bit plus one additional clock. 

4. Only a value of one bit is allowed in the B 1 7 10. 
B 1720 Notes 

The basic clock of the B 1720 is 6 megahertz. 

1 . If the relative address is not within control memory (therefore in main memory), there are 
two clocks. 

2. There is one clock per bit. 

3. There are five clocks per 16 bits (one micro-instruction) plus five clocks. 

4. READ is five clocks until the processor receives the data. WRITE is four clocks until the 
processor is released. Some instructions may be performed during the processor READ or 
WRITE command times if they immediately follow the READ or WRITE commands: this 

is called "concurrency". Consecutive READ or WRITE commands operate at MAIN MEMORY 
READ cycle speed (four clocks) or WRITE cycle speed (six clocks) respectively. 

5. The data is presented to the processor and is released in one MAIN MEMORY READ cycle. 
Concurrent execution of certain micro-instructions is performed if they immediately follow 
the SWAP command. The WRITE portion of the SWAP command is begun and performed in 
parallel to the READ portion, and main memory is not available for the duration of a WRITE 
cycle. For consecutive main memory commands, refer to note 4. 
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APPENDIX C: RESERVED WORDS AND SYMBOLS 

Note: Several elements in the following list will not appear elsewhere in this manual, being in the compiler 
for future development or debugging purposes. 



< 

( 
+ 
* 



/ 

—(underscore) 
> 

# 

' (apostrophe) 



A 

ABSOLUTE 

ADD 

ADDRESS 

ADJUST 

ALL 

ALLCODE 

AMPERSAND 

ANALYZE.CODEFILE 

AND 

ANY 

ANY.INTERRUPT 

ARCHITECTURE.NAME 

AS 

ASSIGN 

ASTACK 

AT 

ATTRIBUTE 

BACKWARD 

BASE.LIMIT 

BASE.ZERO 

BEGIN 

BIAS 

BICN 

BIT 

BITS 



BR 


DIFFERENCE 


BRANCH 


DISPATCH 


BRANCH.EXTERNAL 


DOLLAR 


BY 


DOUBLE 


B710 


DOWN 


CA 


DUMP 


CALL 


ELSE 


CALL.EXTERNAL 


EMIT.RETURN.TO.EXTERNAL 


CARRY 


END 


CASSETTE 


EOR 


CAT 


EQL 


CB 


ERROR.FILE 


CC 


EXIT 


CD 


EXPAND 


CHARACTER 


EXTERNAL 


CHECK 


EXTRACT 


CLEAR 


F 


CMND 


FA 


CMPX 


FA.POINTS 


CMPY 


FALSE 


CODE.SEGMENT 


FB 


CODE.SEGMENT.NUMBER 


FINI 


COMPILE 


FIXED 


COMPILER.LEVEL 


FL 


COMPLEMENT 


FLC 


CONSOLE.SWITCHES 


FLCN 


CONSTANT 


FLD 


CONTROL 


FLE 


COUNT 


FLF 


CP 


FOR 


CPL 


FORCE 


CPU 


FORWARD 


CYD 


FRAME 


CYF 


FROM 


CYL 


FT 


DATA 


FU 


DATA.LENGTH 


GEQ 


DATA.TYPE 


GISMO.LEVEL 


DATA.USAGE 


GO 


DEBUG 


GTR 


DEC 


HALT 


DECK 


HARDWARE.TYPE 


DECLARE 


HEADINGS 


DEFINE 


HEX.SEQUENCE.NUMBER 


DEFINE.VALUE 


HI.PRIORITY 


DETAIL 


HIPRI 


DIFF 


IF 
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INC 


MOD 


SPACE 


S8 


INCLUDE 


MONITOR 


START 


S8A 


INCN 


MOVE 


STOP 


S8B 


INTERRUPT 


MSBX 


STORE 


S9 


INTO 


MSKX 


SUBTITLE 


S9A 


JUMP 


MSKY 


SUBSET 


S9B 


L 


MSMA 


SUBTRACT 


T 


LA 


MSML 


SUM 


TA 


LANGUAGE.EXTENSION 


NEQ 


SUPPRESS 


TABLE 


LB 


NEW 


SWAP 


TAPE 


LC 


NEWSEGMENT 


SO 


TAS 


LD 


NO 


SOA 


TB 


LE 


NO.DEVICE 


SOB 


TC 


LEFT 


NODEVICE 


SI 


TD 


LENGTH.BETWEEN.ENTRIES 


NOP 


S1A 


TE 


LEQ 


NOPS 


SIB 


TEST 


LF 


NORMALIZE 


S10 


TF 


LINES.PER.PAGE 


NOT 


S10A 


THEN 


LIST 


NULL 


S10B 


TITLE 


LIST.NOW 


OLD.LISTING.FORMAT 


SI 1 


TO 


LIST.PATCHES 


OLDIPB 


sua 


TODAYS.DATE 


LISTALL 


OR 


sub 


TODAYS.TIME 


LISTP 


OVERLAY 


S12 


TOPM 


LIT 


PAGE 


S12A 


TRACE 


LOAD 


PAGE.NUMBERS 


S12B 


TRANSFER.CONTROL 


LOAD.MSMA 


PARAMETER.BLOCK 


S13 


TRUE 


LOAD.SMEM 


pass:end 


S13A 


U 


LOCAL.DEFINES 


PLUS 


S13B 


UNIT 


LOCATION 


POINT 


S14 


UNLOCKED 


LOCK 


PORT 


S14A 


UP 


LOCKED 


PROGRAM.LEVEL 


S14B 


VALUE 


LOCKOUT 


PROTECT 


S15 


VOID * 


LR 


READ 


S15A 


WHEN 


LSBX 


REDUNDANT.CODE 


S15B 


WITH 


LSBY 


RELEASE 


S2 


WRITE 


LSS 


REMAPS 


S2A 


WRITE. STRING 


LSUX 


RESERVE.SPACE 


S2B 


X 


LSUY 


RESET 


S3 


XANY 


M 


REVERSE 


S3A 


XCH 


M.MEMORY.BOUNDARY 


RIGHT 


S3B 


XEOY 


MACRO 


ROTATE 


S4 


XORY 


MAKE.SEGMENT.TABLE 


S 


S4A 


XREF 


MAP 


S.MEMORY.LOAD 


S4B 


XREF.ALL 


MAXIMUM 


SEGMENT 


S5 


XREF.LABELS 


MAXM 


SEGMENT.COUNT 


S5A 


XREF.NAMES 


MAXS 


SEQ 


S5B 


XREF.REGISTERS 


MBR 


SET 


S6 


XREF.ZIP 


MCP. LEVEL 


SFL 


S6A 


XY 


MERGE 


SFU 


S6B 


XYCN 


MICRO 


SHIFT 


S7 


XYST 


MINIMUM 


SINGLE 


S7A 


Y 


MINUS 


SKIP 


S7B 
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A Register 7.7 

A Stack 7.7 

Add Scratchpad Micro-Instruction 8-2 

Adjust Location Statement 5-1, 8-3 

Ampersand Cards A-5, A-6 

AND Statement 8-4, 8-5 

Any. Interrupt Bit 7-12 

Architecture. Name . 8-6 

Arithmetic Expressions 3-9, 3-10 

Array Declarations 6-2 

Array Group Items 6-5 

Arrays: Maximum Size 6-1 

Assign Statement _ 8-6 

Attribute 8-6 

Base Register 7-6 

Base. Zero 6-3 

Begin Statement 8-7, 8-8 

Begin/End Code Blocks 8-7 

Bias Micro-Instruction B-5 

Bias Statement 8-9, 8-10 

BICN Register ............' 7-1 1 

Bit Data Fields 6-1 

Bit Strings 3.5, 3.6 

Bit Test Branch False Micro-Instruction B-5, B-6 

Bit Test Branch True Micro-Instruction B-6 

BR Register . .••- 7-6 

Branch Micro-Instruction B-6 

Branch. External Statement 8-11 

C Register 7.7 

CA Register 7.7 

Call Micro-Instruction B-7 

Call Statement 8-12 

Call. External Statement 8-13 

Card Terminator 3-4 ; 3.5 

Carry Micro-Instruction 7.9 

Carry Statement 8-14 

Cassette Control Micro-Instruction B-7 

Cassette Control Statement 8-15 

CB Register 7.7 

CC Register 7.7 ( 7-12 

CD Register . . 7-7,7-12 

Character Data Fields 6-1 

Character Strings 3.7 

Clear Registers Micro-Instruction B-8 
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Clear Statement 8-16 

CMND Register • • 7-10 

CMPX Register 7-8 

CMPY Register . . . 7-8 

Code.Segment Statement 5-1, 5-3 through 5-7 

Combinatorial Logic 7-8 

Compiler Control Cards A-l 

Compiler Files A-6, A-7 

Compiler. Level . . 8-6 

Complement Statement • ■ 8-18,8-19 

Condition Registers • • 7-11 

Condition Registers Summary B-2 

Console Interrupt 7-12,7-13 

Console. Switches Register 7-10 

Constant Registers 7-10 

Correspondence Table 5-2,8-59 

Count FA/FL Micro-Instruction B-8 

Count Statement 8-20,8-21 

CP Register 7-7 

CPL Register 7-7,7-8,8-9,8-10 

CPU Register 7-7,7-8,8-9,8-10 

CYD Register 7-9,7-11 

CYF Register 7-7,7-11 

CYL Register 7-11 

DataRegister 7-10 

Data Types 6-1 

Data.Length 3-8,6-8,6-10 

DEC Statement 8-22 

Declarations Maximum Number 6-1 

Declare Statement 6-1, 6-6 through 6-1 1 

Decrement Statement 8-22 

Define Statement 8-23 

Define. Value Statement • 8-24 

Diff Register 7-9 

Digit 3-1 

Dispatch Micro-Instruction B-9, B-10 

Dispatch Statement 8-25, 8-26 

Dollar Cards • • A-2, A-5 

Dummy 6-6 

Elementary Items 6-4 

Else Statement 8-27,8-28 

Emit.Return.To.External Statement 8-29 

End Statement • 8-30 

EOR Statement 8-31,8-32 

Exchange Scratchpads with F Register Statement 8-99 
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F Register 7-6 
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Field Length Conditions Register 7-11,7-13 

Filler . 6-5, 6-6, 6-7 

FINI Statement 8-37 

Fixed Data Fields 6-1 

FLCN Register 7-11,7-13 

Four-Bit Manipulate Micro-Instruction B-10, B- 11 

FU Register 8-10 

Function Box 7-8 

GISMO.Level 8-6 

GO TO Statement 8-38 

Group Items 6-4 

Halt Micro-Instruction B-l 1 

Halt Statement 8-39 

I/O Service Request Interrupt 7-12 

Identifier 3-2, 3-3 

IF Statement 8-40 through 8-45 

IF Statement . 8-7 
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INC Statement 8-46 
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Jump Statement 8-47 
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Letter 3-1 

Level Numbers 6-4, 6-8 

Limit Register 7-6 
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LSUX 7-12 

LSUY 7-11 
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MACRO Declaration Statement 8-55, 8-56 

MACRO Reference 8-57,8-58 

MACROS 8-55,8-58 

Make. Segment.Table. Entry Statement 8-59 

MAXM Register 7-10 

MAXS Register 7-10 
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MCP.Level 8-6 
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Micro-Instruction Decoding 7-6 
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Monitor Statement 8-62 
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Move 24-Bit Literal Micro-Instruction B-13 
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NO Operation Micro-Instruction B-13 
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Normalize X Micro-Instruction B-13 
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OR Statement 8-67,8-68 
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Index-4 



INDEX (Cont) 
Item Page 

Page Statement 8-70 

Parity Error 7-12 

Parity Error Interrupt . . . . - 7-13 

Physical, Label 5-1 

Point 3-1 

Point FA Clause 8-74, 8-96 

Point Statement 8-71 

Point.Label 3-3 

Port Device Interrupts 7-13 

Program, Level Statement 8-72 
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Reset Statement 8-77 

Result Registers 7-8, 7-9 
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Shift/Rotate XY Left/Right Micro-Instruction B-l 9 
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XEOY Register . . . 7-8 

XORY Register 7-8 

XYCN Register 7-11 
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